NPM、Yarn、PNPM：三大包管理器全方位对比

NPM、Yarn、PNPM：三大包管理器全方位对比

在前端和 Node.js 项目的开发中，包管理器一直扮演着举足轻重的角色。它能帮助我们轻松管理依赖、安装并维护版本，为项目开发提供良好的生态支持。当前主流的包管理器主要有 NPM、Yarn 和 PNPM。

一、简介

1. NPM (Node Package Manager)

• 背景：诞生于 2010 年，作为 Node.js 官方自带的包管理器，NPM 几乎是最早、使用最广泛的 JavaScript 包管理工具
• 特点：
  • 采用集中式的包仓库
  • 命令行工具丰富，基本涵盖依赖管理的方方面面
• 版本：目前常见版本是 NPM 10 及以上

2. Yarn

• 背景：诞生于 2016 年，由 Facebook 等团队主导开发。初衷是为了提升依赖安装速度和一致性，弥补 NPM 在一些场景下的不足
• 特点：
  • 并行下载、完善的缓存机制，极大提高安装速度
  • 强调确定性安装，对锁文件的管理非常严格
• 版本：目前主流版本是 Yarn 2.x（也称 Yarn Berry）及以上

3. PNPM

• 背景：同样于 2016 年推出，是近些年快速崛起的高效包管理器
• 特点：
  • 通过硬链接和符号链接管理依赖，极大减少磁盘占用与重复下载
  • 对大型项目和 Monorepo 有很好的支持
• 版本：最新常见版本是 PNPM 10 及以上

二、安装

1. NPM

- 随着 Node.js 一同安装，无需额外步骤。

2. Yarn

- 需要单独安装，可通过 NPM 或其他包管理工具（如 Homebrew）安装。

npm install -g yarn

3. PNPM

- 同样可以通过 NPM 全局安装。

npm install -g pnpm

三、基本命令

功能	NPM 命令	Yarn 命令	PNPM 命令
安装依赖	npm install	yarn install	pnpm install
安装特定包	npm install	yarn add	pnpm add
移除包	npm uninstall	yarn remove	pnpm remove
更新包	npm update	yarn upgrade	pnpm update
初始化项目	npm init	yarn init	pnpm init

四、性能比较

1. 安装速度

• NPM：早期版本安装较慢，主要因为其串行下载机制；后续版本有一定优化，但整体速度略逊色
• Yarn：通过并行下载和本地缓存显著加快依赖安装，速度体验优于传统 NPM
• PNPM：利用硬链接和符号链接，大幅减少包重复下载和磁盘写入，被普遍认为在速度上更具优势

2. 磁盘空间占用

• NPM：默认在每个项目中都会生成完整的 node_modules，依赖包会被多次拷贝
• Yarn：具备全局缓存，但仍为各项目生成独立的依赖文件夹
• PNPM：采用硬链接/符号链接技术，将同一依赖保存在全局或专用存储目录中，大幅降低磁盘占用

五、确定性安装

1. NPM

• 锁文件：package-lock.json
• 作用：锁定依赖版本，从而确保跨环境的一致性，但早期某些版本在不同平台间会出现一些差异

2. Yarn

• 锁文件：yarn.lock
• 作用：将依赖精确到子依赖级别，跨平台一致性较好

3. PNPM

• 锁文件：pnpm-lock.yaml
• 作用：进一步提升包版本确定性，减少潜在冲突，使用体验与 Yarn 类似

六、工作空间（Workspaces）

工作空间是将多个子包或模块聚合到一个主项目中管理的方案，尤其适用于 Monorepo 场景

1. NPM

• 从 NPM 7 开始原生支持工作空间，但功能相对简单，需要在顶层 package.json 中指定 “workspaces” 字段

2. Yarn

• 在 Yarn 1 就已经支持 Workspace，Yarn 2 之后（Yarn Berry）功能更强大，可自动识别和管理各包依赖

3. PNPM

• 对 Monorepo 友好度高，工作空间配置灵活，对依赖的共享和版本管理做了深度优化

七、包管理策略

1. NPM

• 默认将依赖安装到项目内的 node_modules 文件夹
• 可以通过 npm link 在本地进行包的软链接，适合本地开发

2. Yarn

• 传统模式仍使用 node_modules，但在 Yarn 2 的 Plug’n’Play 模式中，会通过 pnp 文件取代 node_modules
• 同样支持 yarn link 进行本地开发调试

3. PNPM

• 采用硬链接和符号链接，依赖可以集中存放在全局或统一目录下，大幅减少重复安装
• 提供 pnpm link 功能，方便在本地调试多个包

八、社区和生态

1. NPM

• 最早、使用最为广泛，包数量庞大，社区活跃度最高
• 绝大多数开源项目都默认支持 NPM 安装

2. Yarn

• 得益于 Facebook 和开源社区的推动，发展迅速
• 一些先进功能（如 Plug’n’Play）吸引了不少开发者，尤其在前端大型项目中有较多使用

3. PNPM

• 近年在大型团队和企业中受到青睐，因其在磁盘占用和速度上的优势
• 虽然社区规模相对较小，但增长非常快，文档和生态也在不断完善

九、兼容性和迁移

1. NPM

• Node.js 官方默认，兼容性最佳，几乎所有框架和工具都对其开箱即用

2. Yarn

• 高度兼容 NPM，包的来源和语法与 NPM 基本一致
• 可以使用 yarn import 将 NPM 的 package-lock.json 转化为 yarn.lock

3. PNPM

• 同样兼容 NPM，大多数情况下可直接迁移
• 提供多种迁移指令和文档辅助，转化过程相对顺畅

十、总结

• NPM
  • 作为官方默认包管理器，生态最广，使用门槛最低
  • 如果团队对安装速度和磁盘占用要求不高，或已有成熟的 NPM 流程，直接用 NPM 更省事
• Yarn
  • 安装速度快，对锁文件管理更严格，跨平台一致性更高
  • 在注重开发效率、并行安装，或需要使用先进特性的项目中，Yarn 往往更合适
• PNPM
  • 借助硬链接实现“去重”，速度与磁盘利用率表现极佳，尤其适合 Monorepo 或多模块大型项目
  • 如果你在意依赖管理的性能和空间占用，PNPM 会给你带来更好的体验