npm / yarn / pnpm 完整对比

文章目录

• • • 一、基本信息
    • 二、核心差异：存储与链接方式
    • 三、多维度详细对比
    • 四、什么是幽灵依赖？
    • 五、常用命令对照
    • 六、其他重要细节
    • 七、适用场景建议
    • 八、迁移建议（以 npm → pnpm 为例）
    • 九、一句话总结

目前 JavaScript 生态中最主流的三个包管理器是 npm、yarn 和 pnpm。它们都能完成安装依赖、管理版本、运行脚本等基础工作，但在存储方式、安装速度、磁盘占用、依赖严格性等方面差异明显。

一、基本信息

注：yarn 分为 Classic（v1） 和 Berry（v2+）。现在讨论的优势大多指 Berry，尤其是其 Plug’n’Play（PnP）模式。

二、核心差异：存储与链接方式

pnpm 的核心优势：

• 相同内容的文件在磁盘上只存一份
• 项目通过硬链接引用，几乎不占额外空间
• 多项目场景下磁盘占用可减少 50%~80%

三、多维度详细对比

四、什么是幽灵依赖？

幽灵依赖（Phantom Dependencies）：代码里可以 import 一个没有在 package.json 中声明的包。

原因是 npm / yarn Classic 会把间接依赖提升到 node_modules 顶层。

危害：

• 本地能跑，换环境或依赖升级后可能突然报错
• 依赖关系不清晰，不利于维护

pnpm 通过非扁平的严格结构，从根源上阻止了这个问题——只有你明确声明的依赖才能被访问。

五、常用命令对照

六、其他重要细节

1. Corepack（推荐使用） Node.js 自带的包管理器管理工具，可统一管理 npm / yarn / pnpm 的版本：

corepack enable
corepack prepare pnpm@latest –activate

2. 安全相关

• 三者都支持审计（audit）和完整性校验
• pnpm 支持 minimumReleaseAge（只安装发布一段时间后的包，降低供应链风险）
• yarn Berry 默认对 postinstall 脚本更谨慎

3. 离线安装

• npm：npm ci
• yarn：yarn install –offline
• pnpm：pnpm install –offline

七、适用场景建议

八、迁移建议（以 npm → pnpm 为例）

# 启用 corepack
corepack enable

# 安装并使用 pnpm
pnpm install

# 删除旧的 lock 文件
rm package-lock.json

大多数项目几乎无痛切换，只有极少数依赖扁平结构的老包可能需要微调。

九、一句话总结

• npm：官方默认，最稳最省心，适合入门和追求兼容的场景。
• yarn：曾经解决了 npm 的速度和确定性问题，现在 Berry 版本功能强大，尤其适合喜欢插件和 PnP 的团队。
• pnpm：目前综合表现最均衡，省空间、速度快、依赖严格，是 2025~2026 年很多新项目的首选。

当前趋势：新项目越来越多默认选择 pnpm，npm 继续作为兜底方案存在，yarn 则在 monorepo 和特定团队中保持影响力。

🚀 感谢阅读！想了解更多？

📖 我的博客网站 | 记录思考，分享干货 🏡 我的个人主页 | 关于我、开源项目