一、安装步骤
1.全局安装 pnpm
javascript
npm install -g pnpm
2.验证安装
javascript
pnpm -v
输出版本号即表示安装成功。
二、升级 pnpm
若已安装旧版本,可通过以下命令升级:
javascript
npm install -g pnpm@latest
三、配置镜像加速
设置淘宝镜像
javascript
pnpm config set registry https://registry.npmmirror.com
验证配置
javascript
pnpm config get registry
四、常用命令对比
功能 | npm 命令 | pnpm 命令 |
---|---|---|
安装依赖 | npm install | pnpm install |
添加依赖 | npm add | pnpm add |
移除依赖 | npm remove | pnpm remove |
运行脚本 | npm run dev | pnpm dev |
全局安装 | npm install -g | pnpm remove |
五、迁移现有项目
1.删除 node_modules
javascript
rm -rf node_modules
2.使用 pnpm 安装依赖
javascript
pnpm install
3.更新 CI/CD 配置
将 npm install 替换为 pnpm install
将 npm run build 替换为 pnpm build
六、常见问题
安装失败
检查 Node.js 版本(需 ≥12.17)
清理 npm 缓存:
javascript
npm cache clean --force
兼容性问题
使用 --shamefully-hoist 提升依赖:
无法安装插件可以执行这个指令!
javascript
pnpm install --shamefully-hoist
全局包路径
查看全局包位置:
javascript
pnpm root -g
七、卸载 pnpm
全局卸载
javascript
npm uninstall -g pnpm
清理配置
javascript
rm -rf ~/.pnpm-store