5月28日 01:02

pnpm 的性能优势体现在哪些方面？与 npm/Yarn 对比如何？

pnpm 的性能优势集中在三个层面：安装速度、磁盘占用和依赖安全性。下面逐项拆解，并与 npm、Yarn 做横向对比。

安装速度：硬链接让缓存安装接近即时

pnpm 在有缓存时的安装速度远超 npm 和 Yarn，核心原因是硬链接机制——同一台机器上只要某个包的版本曾经下载过，后续项目安装时直接从全局 store 创建硬链接，无需重复拷贝文件。

场景	npm	Yarn Berry (PnP)	pnpm
冷安装（无缓存）	45-55s	30-40s	25-35s
热安装（有缓存）	18-25s	10-15s	2-4s
删 node_modules 重装	40-50s	25-35s	3-5s

数据来源：基于 2026 年社区基准测试（Monorepo 场景，~1500 依赖）。冷安装差距主要来自 pnpm 的并行下载策略；热安装差距则完全由硬链接驱动——pnpm 的热安装本质上是创建文件链接，而非文件拷贝。

磁盘空间：内容寻址存储节省 70% 以上

npm 和 Yarn 的 node_modules 采用扁平化拷贝：每个项目独立存储所有依赖文件。10 个使用相同技术栈的项目，磁盘占用约为 500MB x 10 = 5GB。

pnpm 使用全局内容寻址存储（content-addressable store）：相同内容的文件只存一份，各项目通过硬链接引用。

项目数量	npm 总占用	pnpm 总占用	节省比例
1 个	~500MB	~500MB	0%
5 个	~2.5GB	~550MB	78%
10 个	~5GB	~600MB	88%

项目越多，节省越显著。这对 CI 环境和磁盘受限的开发机尤其重要。

依赖安全性：严格模式杜绝幻影依赖

这常常被忽略，但却是 pnpm 架构上最重要的区别。

npm 和 Yarn 采用扁平化 hoisting——所有依赖（包括间接依赖）都被提升到 node_modules 根目录。这意味着你可以在代码中 require 一个未在 package.json 中声明的包，只要它恰好被其他依赖安装了。这就是幻影依赖（phantom dependency）。

pnpm 的 node_modules 采用嵌套软链接结构：

shell
node_modules/
  .pnpm/
    lodash@4.17.21/
      node_modules/
        lodash -> 硬链接到全局 store
  lodash -> .pnpm/lodash@4.17.21/node_modules/lodash

你只能访问 package.json 中显式声明的包。间接依赖被严格隔离在 .pnpm 目录内，不会泄露到你的代码中。这避免了以下常见问题：

某个间接依赖被上游移除后，你的代码突然报错
不同版本的同名包产生意外冲突
团队成员之间依赖行为不一致

架构差异决定性能差距

三种包管理器的核心区别在于 node_modules 的组织方式：

特性	npm	Yarn Berry	pnpm
node_modules 结构	扁平化拷贝	PnP 虚拟文件系统	嵌套软链接 + 硬链接
依赖存储	每项目独立拷贝	单个 .pnp.cjs 映射	全局 store 共享
幻影依赖	有	无（PnP 模式）	无
硬链接复用	不支持	不支持	支持
Monorepo 支持	基础 workspaces	原生支持	原生 + workspace 协议

什么场景选 pnpm

多项目开发环境：磁盘节省最明显，热安装接近即时
Monorepo 项目：内置 workspace 协议和过滤，原生支持子项目间依赖联动
CI/CD 流水线：配合 prefer-frozen-lockfile=true，冷安装速度也有明显优势
团队协作：严格依赖模式保证每个人的依赖行为一致，减少"我这能跑你那不行"的问题

什么场景不选 pnpm

小型项目、原型验证：npm 零配置直接上手更省事
依赖大量 native 模块（如 node-gyp）：硬链接有时会遇到权限问题
现有项目已深度依赖 Yarn 插件生态：迁移成本需要评估

追问：pnpm 的局限性和注意事项

严格模式可能导致兼容问题：某些包假设了扁平化结构，在 pnpm 下可能报错，可通过 .npmrc 中设置 shamefully-hoist=true 回退到扁平模式（但会失去幻影依赖保护）
全局 store 需要定期清理：使用 pnpm store prune 清理不再被引用的包
与 Yarn PnP 的取舍：Yarn PnP 甚至不生成 node_modules 目录，安装更快但生态兼容性更差；pnpm 在性能和兼容性之间取了更好的平衡

标签：PNPM