pnpm 你用了吗？

pnpm 详解：更快、更省空间的现代化包管理器

一、什么是 pnpm？

pnpm （p erformant npm ）是一个快速、节省磁盘空间的 Node.js 包管理器。它通过 硬链接 + 符号链接 的方式，在全局存储中只保存一份依赖包，多个项目共享同一份物理文件，从而显著减少磁盘占用并提升安装速度。

官网：pnpm.io

---

二、核心优势

✅ 1. 节省磁盘空间

• npm/yarn 每个项目都会复制完整依赖树。
• pnpm 使用 内容可寻址存储（Content-addressable store） ，相同版本的包只存一次。
• 实测 ：10 个相似项目，pnpm 可节省 70%+ 磁盘空间。

✅ 2. 安装速度更快

• 无需重复下载/解压相同包。
• 并行化处理 + 高效的依赖解析算法。
• CI/CD 或大型项目中优势显著。

✅ 3. 严格的依赖隔离（无幽灵依赖）

• pnpm 严格遵循 node_modules 的 symlink 结构，只暴露显式声明的依赖。
• 避免 npm/yarn 中常见的"未声明却能引用"的 幽灵依赖 问题，提升项目健壮性。

✅ 4. 原生支持 Monorepo（多项目管理）

• 内置 pnpm workspace 功能，无需额外工具（如 Lerna）即可高效管理多个子项目。
• 支持跨项目链接、统一依赖升级、脚本批量执行等。

---

三、安装 pnpm

全局安装（推荐）

# 使用 npm
npm install -g pnpm

# 使用 corepack（Node.js 16.13+ 内置）
corepack enable
corepack prepare pnpm@latest --activate

💡 建议使用 corepack，它是官方推荐的包管理器分发方式，避免全局污染。

验证安装

pnpm -v
# 输出如：9.12.0

---

四、基本使用命令

功能	命令
初始化项目	pnpm init
安装依赖	pnpm install 或 pnpm i
添加依赖	pnpm add lodash
添加开发依赖	pnpm add -D typescript
删除依赖	pnpm remove lodash
运行脚本	pnpm run dev
查看依赖树	pnpm list
清理 store	pnpm store prune

⚠️ 注意：pnpm 不支持 npm install package --save 这种写法，必须用 pnpm add。

---

五、版本策略

• pnpm 遵循 SemVer（语义化版本） 。
• 主版本更新较快（目前 v9.x），但 API 稳定。
• 推荐使用 最新稳定版 ，可通过 pnpm env use --global latest 自动管理 Node.js + pnpm 版本。

---

六、多项目管理：pnpm Workspace 详解（核心亮点）

1. 什么是 Workspace？

Workspace 是 pnpm 提供的 Monorepo 管理方案，允许在一个仓库中管理多个相互关联的包（如组件库、微前端、工具链等）。

2. 配置步骤

(1) 根目录创建 pnpm-workspace.yaml

packages:
  - 'packages/*'
  - 'apps/*'
  - '!**/test/**'  # 排除测试目录

(2) 子项目结构示例

my-monorepo/
├── packages/
│   ├── ui-components/
│   └── utils/
├── apps/
│   ├── web-app/
│   └── admin/
├── pnpm-workspace.yaml
└── package.json

(3) 跨项目引用（自动软链接）

在 apps/web-app/package.json 中：

{
  "dependencies": {
    "ui-components": "workspace:*",
    "utils": "workspace:^1.0.0"
  }
}

运行 pnpm install 后，ui-components 和 utils 会自动以 符号链接 形式链接到 web-app/node_modules，实现 实时开发调试 ，无需 npm link。

3. 批量操作命令

# 在所有 workspace 中运行 build
pnpm -r run build

# 仅在包含 test 脚本的项目中运行
pnpm -r --filter='./packages/**' run test

# 查看所有 workspace 依赖关系图
pnpm m ls

4. 优势总结（vs Lerna + Yarn/NPM）

能力	pnpm Workspace	Lerna + Yarn
依赖安装	单次 pnpm install 完成	需 lerna bootstrap
磁盘占用	极低（共享 store）	高（每个项目独立 node_modules）
幽灵依赖	严格禁止	可能存在
配置复杂度	极简（一个 yaml 文件）	需 Lerna + Yarn 配置
性能	快	较慢

🚀 结论 ：对于新项目，直接使用 pnpm workspace 是 Monorepo 的最佳实践。

---

七、常见问题 & 最佳实践

Q1: pnpm 和 npm/yarn 兼容吗？

• 完全兼容 package.json 和 npm registry。
• 可无缝迁移：删除 node_modules 和 package-lock.json，运行 pnpm import（从 yarn.lock/npm-lock）或直接 pnpm install。

Q2: 如何迁移现有项目到 pnpm？

# 1. 删除旧依赖
rm -rf node_modules package-lock.json

# 2. 安装 pnpm 依赖
pnpm install

# 3. （可选）从 yarn.lock 导入
pnpm import  # 自动读取 yarn.lock 或 package-lock.json

Q3: pnpm 支持 .npmrc 吗？

• 支持！配置方式与 npm 一致，如设置 registry、token 等。

最佳实践建议：

• 在 .nvmrc 或 .tool-versions 中指定 Node.js 版本。
• 使用 pnpm dlx 临时运行包（替代 npx）：pnpm dlx create-react-app my-app
• 开启 hoist=false（默认）以保持严格依赖隔离。

---

八、结语

pnpm 不仅是一个更快的 npm 替代品，更是现代前端工程化的基础设施 。它在 磁盘效率、安装速度、依赖安全性和 Monorepo 支持 上全面领先，已被 Vite、Next.js、Nuxt、Turborepo 等主流工具链官方推荐。

如果你还在忍受 node_modules 的臃肿和幽灵依赖的困扰，现在就是切换到 pnpm 的最佳时机！

---

🔗 参考链接：

• pnpm 官方文档
• pnpm vs npm vs yarn 性能对比
• Vite 官方推荐使用 pnpm

---

欢迎点赞、收藏、评论交流！你用过 pnpm 吗？体验如何？ 😊

---

📄 附：文档结构说明

章节	内容
一	pnpm 简介
二	核心优势（含多项目管理）
三	安装方法
四	常用命令
五	版本管理
六	Monorepo 深度解析
七	常见问题与迁移指南
八	总结与推荐