pnpm 和 npm，它们都是 Node.js 的包管理器，但在依赖管理机制、性能、磁盘空间、工作流和功能上存在显著区别：
🔧 1. 核心依赖管理机制
npm (v3+):
使用 扁平化依赖结构 (flat node_modules)。所有依赖（包括子依赖）会尽量提升到顶层 node_modules，可能导致依赖分身（同一个包的不同版本同时存在）和幽灵依赖（项目代码可能访问到未声明的依赖）。
pnpm:
使用 内容可寻址存储 + 硬链接。
- 内容可寻址存储: 所有包以 只读 形式存储在一个全局仓库 (~/.pnpm-store) 中，通过内容哈希唯一标识。
- 硬链接: 项目中的 node_modules 只包含你直接依赖的包，这些包是全局仓库中对应包的硬链接（非副本）。
- 符号链接: 子依赖通过符号链接指向全局仓库中的对应版本。
- 结果: 依赖严格隔离（避免分身和幽灵依赖），节省磁盘空间，安装速度更快。
⚡ 2. 性能与磁盘空间
安装速度:
pnpm 通常显著快于 npm，尤其在冷安装（第一次安装）和增量安装（添加新包）时。得益于硬链接和并行下载。
npm 需要解压大量 tarball 并处理扁平化结构，速度较慢。
磁盘空间:
pnpm 极大节省空间。同一个包的不同版本在全局仓库中只存储一份内容，项目间共享。
npm 每个项目都会存储完整的依赖树副本，冗余度高。
📂 3. node_modules 结构
npm:
扁平化结构。依赖层次不清晰，可能出现“依赖提升”，导致项目代码可能意外访问到未在 package.json 中声明的包（幽灵依赖）。
pnpm:
非扁平化、严格结构：
node_modules/
├── .pnpm/ # 所有依赖的硬链接和符号链接都在这
├── .modules.yaml # pnpm 的模块清单
├── foo@1.0.0/ # 直接依赖 foo 是硬链接 (指向全局仓库)
└── bar@2.0.0/ # 直接依赖 bar 是硬链接
项目代码只能访问在 package.json 中显式声明的直接依赖。无幽灵依赖。
🔖 4. 常用命令对比
| 操作 | npm 命令 | pnpm 命令 | 主要区别说明 |
|---|---|---|---|
| 初始化项目 | npm init / npm init -y | pnpm init / pnpm init -y | 行为基本一致 |
| 安装所有依赖 | npm install (npm i) | pnpm install (pnpm i) | pnpm 利用硬链接和缓存，速度更快，磁盘占用更低 |
| 添加生产依赖 | npm install <pkg> | pnpm add <pkg> | pnpm 默认使用 add 语法更清晰 |
| 添加开发依赖 | npm install -D <pkg> | pnpm add -D <pkg> | 同上 |
| 添加全局包 | npm install -g <pkg> | pnpm add -g <pkg> | pnpm 的全局包也使用符号链接，更节省空间 |
| 移除依赖 | npm uninstall <pkg> | pnpm remove <pkg> (pnpm rm) | 行为一致 |
| 运行脚本 | npm run <script> | pnpm <script> | pnpm 直接运行更简洁 (e.g., pnpm dev) |
| 更新依赖 | npm update | pnpm update | pnpm 更新更严格，依赖锁文件(pnpm-lock.yaml) |
| 列出依赖 | npm ls | pnpm ls | pnpm 显示更清晰的树状结构 |
| 检查过期依赖 | npm outdated | pnpm outdated | 行为基本一致 |
| 执行npx | npx <command> | pnpm dlx <command> | pnpm 使用 dlx (下载并执行) |
🧩 5. 特有功能与优势
pnpm Workspaces (monorepo 支持)：
内置且成熟度高。通过根目录的 pnpm-workspace.yaml 定义子包。
命令如 pnpm -F add 为指定子包添加依赖。
依赖提升优化：可配置将公共依赖提升到根 node_modules (通过 .npmrc 设置 hoist=true)，进一步节省空间。
pnpm 的严格性：
强制 peerDependencies 自动安装（通过 auto-install-peers=true 配置），避免遗漏。
默认无幽灵依赖，提升项目健壮性和可复现性。
配置文件：
pnpm 使用 pnpm-lock.yaml (格式类似于 yarn v1+)，比 npm 的 package-lock.json 更紧凑、更易读、合并冲突更少。
可通过 .npmrc 配置，但配置项名称可能略有不同 (e.g., shamefully-hoist)。
⚠️ 6. 兼容性与迁移
兼容性：
pnpm 完全兼容 package.json 和 npm 的语义化版本规范。
绝大多数 npm 包可以直接用 pnpm 安装使用。
迁移：
非常容易：在已有项目根目录运行 pnpm import 可以将 package-lock.json 或 yarn.lock 转换成 pnpm-lock.yaml。
然后运行 pnpm install 即可。
注意检查是否有幽灵依赖（代码中引用了未在 package.json 声明的包），迁移后可能会暴露问题。
💎 总结关键差异
| 维度 | npm | pnpm |
|---|---|---|
| 依赖结构 | 扁平化 (易有幽灵依赖) | 硬链接+符号链接 (严格隔离) |
| 安装速度 | 较慢 | 更快 🚀 |
| 磁盘空间 | 冗余度高 | 显著节省 💾 (共享存储) |
| 命令简洁性 | 标准 (e.g., npm install) | 更简洁 (e.g., pnpm add) |
| 安全性/隔离性 | 较弱 (幽灵依赖风险) | 强 (无幽灵依赖) |
| Monorepo支持 | 需借助 Lerna 等工具 | 内置成熟 Workspaces 🌟 |
| Lockfile | package-lock.json (较复杂) | pnpm-lock.yaml (更简洁) |
| 哲学 | 易用性优先 | 效率、严格性、磁盘优化 |
🎯 建议：
如果你是新项目或磁盘空间敏感，强烈推荐 pnpm，尤其是 Monorepo 场景。
迁移现有项目前，务必检查并修复可能的幽灵依赖。
大部分项目可以无缝切换，享受速度和空间红利！