如何安装 pnpm 和 cnpm

前提:你已经安装了 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 常用命令对照

操作npmpnpm
安装依赖npm installpnpm install
启动项目npm run devpnpm dev
添加依赖npm install axiospnpm add axios
全局安装npm install -gpnpm 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 + 国内镜像

发表回复