pnpm 入门与实践指南

pnpm 入门与实践指南

一个高效、快速、节省磁盘空间的 Node.js 包管理器替代方案。

为什么选择 pnpm?

  • 🧩 节省磁盘空间:pnpm 通过硬链接共享依赖,避免重复安装。
  • 🚀 安装速度更快:相比 npm/yarn 更高效。
  • 🔐 默认严格依赖:避免隐式依赖,项目更稳定。
  • 🛠️ 更好的工作区支持:内建 monorepo 管理工具,媲美 Lerna + Yarn Workspaces。

安装 pnpm

你可以通过 npm 安装 pnpm:

bash 复制代码
npm install -g pnpm

或者使用 corepack(Node.js >= 16.13.0):

bash 复制代码
corepack enable
corepack prepare pnpm@latest --activate

验证版本:

bash 复制代码
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

json 复制代码
{
  "name": "my-monorepo",
  "private": true,
  "workspaces": ["packages/*"]
}

pnpm-workspace.yaml

yaml 复制代码
packages:
  - 'packages/*'

常见问题与解决方案

Q: 项目引用未生效?

A: 确保在根目录运行 pnpm install,而非子项目。

Q: 某些依赖无法安装?

A: 尝试加上 --shamefully-hoist 参数兼容旧项目:

bash 复制代码
pnpm install --shamefully-hoist

小技巧

只更新部分包

bash 复制代码
pnpm update <package-name>

执行子包命令

bash 复制代码
pnpm -F <package-name> run <script>

总结

如果你正在为项目安装慢、node_modules 体积大、依赖错乱等问题困扰,pnpm 是非常值得尝试的解决方案。它的设计理念与性能优化让它在现代前端工程中表现出色,特别适合 Monorepo 场景。


参考链接

相关推荐
yeyuningzi10 小时前
VUE 运行npm run dev命令提示error Missing script: “dev“
前端·vue.js·npm
草梅友仁3 天前
Npm 安全更新与千星沙箱 | 2025 年第 43 周草梅周报
npm·开源·github
sanzk5 天前
Node.js | pnpm下载安装与环境配置
npm
爱宇阳5 天前
npm 常用标签与使用技巧新手教程
前端·npm·node.js
郑板桥305 天前
TypeScript:npm的types、typings、@type的区别
javascript·typescript·npm
@大迁世界5 天前
2025 年该选谁?npm vs yarn vs pnpm
前端·npm·node.js
crary,记忆5 天前
简介NPM 和 NPX
前端·学习·npm·node.js
前端架构师-老李6 天前
npm、yarn、pnpm的对比和优略
前端·npm·node.js·pnpm·yarn
勉灬之6 天前
通过npm run XXX命令生成uniapp的pages.json文件
npm·uni-app·json
duandashuaige9 天前
解决用electron打包Vue工程(Vite)报错electron : Failed to load URL : xxx... with error : ERR _CONNECTION_REFUSED
javascript·typescript·electron·npm·vue·html