pnpm 和 npm 差异

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. 常用命令对比

🧩 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 声明的包），迁移后可能会暴露问题。

💎 总结关键差异

🎯 建议：
如果你是新项目或磁盘空间敏感，强烈推荐 pnpm，尤其是 Monorepo 场景。
迁移现有项目前，务必检查并修复可能的幽灵依赖。
大部分项目可以无缝切换，享受速度和空间红利！