前提:你已经安装了 Node.js(自带 npm)
验证一下:
node -v
npm -v
一、安装 pnpm(✅ 强烈推荐)
✅ 方式一:用 npm 安装(最常见)
npm install -g pnpm
验证:
pnpm -v
✅ 方式二:Corepack(Node 16.9+ / 企业推荐)
Corepack 是 Node 官方内置工具,更“正规”。
corepack enable
corepack prepare pnpm@latest --activate
验证:
pnpm -v
👉 企业 / CI 环境更推荐这个方式
🔧 pnpm 设置国内镜像(非常重要)
pnpm config set registry https://registry.npmmirror.com
查看:
pnpm config get registry
✅ pnpm 常用命令对照
| 操作 | npm | pnpm |
|---|---|---|
| 安装依赖 | npm install | pnpm install |
| 启动项目 | npm run dev | pnpm dev |
| 添加依赖 | npm install axios | pnpm add axios |
| 全局安装 | npm install -g | pnpm add -g |
二、安装 cnpm(⚠️ 不推荐新项目)
cnpm 本质是 淘宝 npm 镜像 + 客户端
安装 cnpm
npm install -g cnpm --registry=https://registry.npmmirror.com
验证:
cnpm -v
使用方式
cnpm install
⚠️ 注意:
不要在同一个项目里混用 npm / pnpm / cnpm
三、推荐做法(重点看这里)
✅ 国内环境的「最佳实践」
👉 不要装 cnpm
而是:
# npm 换国内镜像
npm config set registry https://registry.npmmirror.com
# 或 pnpm 换国内镜像
pnpm config set registry https://registry.npmmirror.com
这样你可以:
- 用 官方 npm / pnpm
- 享受 国内速度
- 避免 cnpm 的兼容问题
四、pnpm vs cnpm 的最终建议(工程视角)
✔️ 新项目 / 企业项目
pnpm + 国内镜像
理由:
- 依赖更严格
- 磁盘更省
- CI 友好
- Monorepo 友好
⚠️ 什么时候才用 cnpm?
- 非常老的项目
- 已经历史包袱很重
- 不能动依赖结构
五、常见踩坑提醒(很重要)
❌ 1. 混用包管理器
今天 npm install
明天 pnpm install
🚨 非常容易出问题。
❌ 2. 把 cnpm 当“官方 npm”
cnpm ≠ npm
某些行为不一致。
✅ 3. 锁定包管理器(企业必做)
{
"packageManager": "pnpm@9.0.0"
}
六、一句话总结(你可以记这个)
安装 pnpm:npm install -g pnpm(或 corepack)
不推荐 cnpm,新项目用 pnpm + 国内镜像