pnpm 入门与实践指南
pnpm 入门与实践指南
一个高效、快速、节省磁盘空间的 Node.js 包管理器替代方案。
为什么选择 pnpm？
- 🧩 节省磁盘空间：pnpm 通过硬链接共享依赖，避免重复安装。
- 🚀 安装速度更快：相比 npm/yarn 更高效。
- 🔐 默认严格依赖：避免隐式依赖，项目更稳定。
- 🛠️ 更好的工作区支持：内建 monorepo 管理工具，媲美 Lerna + Yarn Workspaces。
安装 pnpm
你可以通过 npm 安装 pnpm：
npm install -g pnpm
或者使用 corepack（Node.js >= 16.13.0）：
corepack enable
corepack prepare pnpm@latest --activate
验证版本：
pnpm -v
常用命令对比
| 操作 | npm | yarn | pnpm |
|---|---|---|---|
| 安装依赖 | npm install | yarn | pnpm install |
| 添加依赖 | npm install lodash | yarn add lodash | pnpm add lodash |
| 添加 dev 依赖 | npm install -D typescript | yarn add -D typescript | pnpm add -D typescript |
| 删除依赖 | npm uninstall lodash | yarn remove lodash | pnpm remove lodash |
| 清空缓存 | npm cache clean --force | yarn cache clean | pnpm store prune |
使用 pnpm workspace 管理 Monorepo
pnpm 原生支持 monorepo，创建项目结构如下：
my-monorepo/
├── package.json
├── pnpm-workspace.yaml
└── packages/├── a/└── b/
根目录 package.json
{"name": "my-monorepo","private": true,"workspaces": ["packages/*"]
}
pnpm-workspace.yaml
packages:- 'packages/*'
常见问题与解决方案
Q: 项目引用未生效？
A: 确保在根目录运行 pnpm install，而非子项目。
Q: 某些依赖无法安装？
A: 尝试加上 --shamefully-hoist 参数兼容旧项目：
pnpm install --shamefully-hoist
小技巧
只更新部分包
pnpm update <package-name>
执行子包命令
pnpm -F <package-name> run <script>
总结
如果你正在为项目安装慢、node_modules 体积大、依赖错乱等问题困扰，pnpm 是非常值得尝试的解决方案。它的设计理念与性能优化让它在现代前端工程中表现出色，特别适合 Monorepo 场景。
参考链接
- pnpm 官网
- pnpm 与 npm/yarn 对比