一、什么是 pnpm?
pnpm(Performant npm)是新一代 JavaScript 包管理器,优势包括:
- 节省磁盘空间:通过硬链接和符号链接实现高效存储
- 安装速度更快:比 npm/yarn 快 2-3 倍
- 内置工作区支持:天然适配 Monorepo 项目
- 安全隔离:默认严格模式防止依赖污染
二、安装方法
1. 通过 npm 安装(推荐)
# 全局安装(需已安装 Node.js)
npm install -g pnpm
# 验证安装
pnpm --version
2. 独立脚本安装(无需 Node.js)
# Linux/macOS
curl -fsSL https://get.pnpm.io/install.sh | sh -
# Windows(PowerShell)
iwr https://get.pnpm.io/install.ps1 -useb | iex
3. 通过系统包管理器
# macOS (Homebrew)
brew install pnpm
# Windows (Chocolatey)
choco install pnpm
# Windows (Scoop)
scoop install pnpm
# Arch Linux
sudo pacman -S pnpm
三、验证安装
pnpm --version
# 输出类似 8.6.1 表示成功
# 创建测试项目
pnpm create vite@latest my-project
cd my-project
pnpm install
pnpm run dev
四、配置镜像加速(国内用户)
# 设置淘宝镜像
pnpm config set registry https://registry.npmmirror.com
# 验证配置
pnpm config get registry
# 应输出 https://registry.npmmirror.com
五、常用命令对比
操作 | npm 命令 | pnpm 命令 |
---|---|---|
安装依赖 | npm install | pnpm install |
全局安装 | npm install -g pkg | pnpm add -g pkg |
运行脚本 | npm run dev | pnpm dev |
添加开发依赖 | npm install --save-dev | pnpm add -D |
六、常见问题
1. 权限问题(Linux/macOS)
# 如果遇到权限错误,使用:
sudo npm install -g pnpm
# 或修复全局安装目录权限
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}
2. 卸载 pnpm
# 通过 npm 安装的版本
npm uninstall -g pnpm
# 通过脚本安装的版本
rm -rf $(npm config get prefix)/lib/node_modules/pnpm
通过以上步骤即可完成 pnpm 的安装。推荐新项目直接使用 pnpm 替代 npm/yarn,可获得更好的开发体验。