npm 安装 pnpm 的详细步骤及注意事项
一、安装步骤
1.全局安装 pnpm
npm install -g pnpm
2.验证安装
pnpm -v
输出版本号即表示安装成功。
二、升级 pnpm
若已安装旧版本，可通过以下命令升级：
npm install -g pnpm@latest
三、配置镜像加速
设置淘宝镜像
pnpm config set registry https://registry.npmmirror.com
验证配置
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
rm -rf node_modules
2.使用 pnpm 安装依赖
pnpm install
3.更新 CI/CD 配置
将 npm install 替换为 pnpm install
将 npm run build 替换为 pnpm build
六、常见问题
安装失败
检查 Node.js 版本（需 ≥12.17）
清理 npm 缓存：
npm cache clean --force
兼容性问题
使用 --shamefully-hoist 提升依赖：
无法安装插件可以执行这个指令！
pnpm install --shamefully-hoist
全局包路径
查看全局包位置：
pnpm root -g
七、卸载 pnpm
全局卸载
npm uninstall -g pnpm
清理配置
rm -rf ~/.pnpm-store