PNPM 入门指南：快且省的现代包管理器
PNPM 用硬链接全局存储 + 符号链接依赖结构，减少重复存储并约束依赖访问。本文讲解核心原理、依赖管理、锁文件与 workspace 实践。
PNPM 的革命性设计：所有包全局只存一份（内容寻址存储），项目 node_modules 用链接引用——安装提速、磁盘节省、依赖幻影问题根治。pnpm add 替代 npm install，其余命令几乎一致。Vue、Svelte 等生态项目官方推荐。
PNPM 的原理
npm/yarn 的 node_modules 是"复制"模式：十个项目依赖同一个 lodash，磁盘上就有十份。PNPM 两步走：
- 全局内容寻址存储（~/.pnpm-store）：每个包的每个版本全局唯一一份；
- 项目内硬链接 + 符号链接：node_modules 里的文件链向全局存储。
结果：装第二个项目几乎零下载零拷贝——CI 缓存 pnpm store 后安装快到飞起。
日常使用
npm install -g pnpm # 或 corepack enable && corepack prepare pnpm@latest --activate
pnpm init # 初始化
pnpm add lodash # 装依赖
pnpm add -D typescript # 开发依赖
pnpm install # 按锁文件安装
pnpm remove lodash # 移除
pnpm update # 更新
pnpm run dev # 跑脚本（可省 run：pnpm dev）
node_modules 的严格结构
PNPM 的 node_modules 只包含直接依赖（间接依赖藏在 .pnpm 目录用符号链接关联）。这修复了臭名昭著的幻影依赖：代码里 require 一个没声明的包，npm 下碰巧能跑（被提升），pnpm 下直接报错——依赖声明被迫诚实。
锁文件与确定性
pnpm-lock.yaml 与 package-lock.json 同职责：锁定完整依赖树。CI 用 pnpm install --frozen-lockfile 保证与锁文件严格一致。
Workspace：monorepo 标配
# pnpm-workspace.yaml
packages:
- 'packages/*'
- 'apps/*'
pnpm add lodash --filter web-app # 给特定包加依赖
pnpm run build --filter "./packages/*" # 批量执行
workspace 协议（"dep": "workspace:*"）引用内部包——pnpm workspace 是 Turborepo/Nx 生态的默认底座。
常见问题（FAQ）
Q：pnpm 和 npm 项目能互转吗？
可以：删 node_modules 与旧锁文件，pnpm import（从 package-lock 转换）或重新 install。团队统一工具即可，锁文件不混用。
Q：某些包在 pnpm 下找不到依赖报错？
那是包本身依赖声明不规范（依赖了幻影依赖）。临时方案 .npmrc 加 public-hoist-pattern[]=*types*，长期给上游提 issue。
Q：和 Bun 的包管理怎么比？
两者都极快。pnpm 的 workspace 成熟度与生态兼容性（Vue/Svelte 官方采用）更稳；Bun 胜在与运行时一体。详见本系列 Bun 相关文章。
参考文档
本文依据公开文档整理，示例需按项目依赖版本验证；不将文档中的性能描述视为本项目实测结果。
