pnpm

节省磁盘的 Node.js 包管理器

补充说明

pnpm 用内容寻址存储和硬链接管理依赖，多个项目共享同一份包文件。它的 node_modules 结构更严格，未声明的依赖通常无法直接引用。

常用示例

pnpm install
pnpm add express
pnpm add -D typescript
pnpm remove express
pnpm run build
pnpm dlx create-vite my-app
pnpm why react
pnpm outdated
pnpm store path
pnpm store prune
pnpm --filter web run build
pnpm -r run test

易错点与排错

• 未在 package.json 声明的依赖可能无法被解析；这是严格结构的设计，不是 bug。
• 依赖的 postinstall 构建脚本在较新版本默认不执行；需要按提示批准或在配置里显式允许。
• node_modules 里是符号链接；某些老工具、打包器或 Docker 复制会不兼容。
• CI 用 pnpm install --frozen-lockfile；lockfile 与 package.json 不一致会失败。
• 全局 store 被清理后，项目依赖需要重新链接；不要在构建中随意 store prune。
• monorepo 里 --filter 和 -r 语义不同；先确认执行范围。
• 和 npm/yarn 混用会生成多份 lockfile，团队要统一包管理器。
• 私有 registry 的认证配置与 npm 类似，但要注意 .npmrc 的作用域。

相关命令

• npm — 官方包管理器
• yarn — 另一种包管理器
• corepack — 锁定包管理器版本