在 Ubuntu 系统中安装 pnpm（高性能包管理器）有以下几种常用方法，结合官方推荐和实际场景需求，以下是详细步骤及注意事项：
一、官方推荐安装方法（无需 sudo，最安全）
步骤 1：安装依赖工具
确保系统已安装 curl，若未安装则执行：
sudo apt update && sudo apt install -y curl
步骤 2：执行官方安装脚本
通过一键脚本自动安装最新稳定版 pnpm：
curl -fsSL https://get.pnpm.io/install.sh | sh –
脚本会自动完成以下操作：
- 下载并安装 pnpm 到用户目录 ~/.local/share/pnpm
- 配置环境变量（自动修改 ~/.bashrc 或 ~/.zshrc）
- 创建符号链接到 ~/.local/bin
步骤 3：激活环境变量
根据使用的 Shell 刷新配置：
source ~/.bashrc # Bash 用户
source ~/.zshrc # Zsh 用户
验证安装
pnpm -v # 输出版本号（如 9.12.3）即成功
二、通过 npm 全局安装（适合已有 npm 环境）
步骤 1：确保 Node.js 和 npm 已安装
若未安装 Node.js，可通过以下命令安装（推荐 LTS 版本）：
sudo apt install nodejs npm
步骤 2：全局安装 pnpm
npm install -g pnpm
常见问题处理
- 权限报错（EACCES）：
避免使用 sudo，修复 npm 全局目录权限：sudo chown -R $USER:$GROUP ~/.npm - 版本冲突：若已通过 npm 安装旧版 pnpm，建议先卸载：npm uninstall -g pnpm
三、通过 nvm 管理 Node.js 版本（多版本场景）
步骤 1：安装 nvm
若未安装，执行：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
步骤 2：安装 Node.js 并绑定 pnpm
nvm install 22 # 安装 Node.js 22（示例版本）
nvm use 22 # 切换到该版本
npm install -g pnpm
四、其他方法
系统包管理器（仅限特定发行版）
Ubuntu 官方仓库暂未提供 pnpm，但可通过 AUR（Arch Linux）或 COPR（Fedora）安装，需谨慎操作。
手动指定版本
若需安装特定版本（如 9.0.0）：
npm install -g pnpm@9.0.0
五、后续优化配置
设置淘宝镜像加速下载
pnpm config set registry https://registry.npmmirror.com
验证镜像：
pnpm config get registry
配置存储路径（可选）
避免默认路径权限问题：
pnpm config set store-dir /custom/store/path
六、常见问题解决
| pnpm: command not found | 重新执行 source ~/.bashrc 或重启终端 |
| 安装依赖超时 | 检查网络或临时使用镜像：pnpm install –registry=https://registry.npmmirror.com |
| 权限错误（EACCES） | 修复存储目录权限：sudo chown -R $USER:$GROUP ~/.pnpm-store |
总结
推荐优先使用 官方脚本安装（方法一），兼顾安全性与便捷性。若需与特定 Node.js 版本绑定，可选择 nvm 方式。安装后通过镜像配置和存储路径优化，可进一步提升使用体验。
