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