根本原因是npm全局bin目录未加入$PATH或shell未加载更新的环境变量；需检查npm config get prefix、将对应/bin加入shell配置并source，同时确保Node.js≥18.17、npm≥9.6，并正确配置pnpm store-dir避免权限问题。
pnpm 安装失败：npm install -g pnpm 不生效？
根本原因不是命令写错，而是 npm 全局 bin 目录没进 $PATH，或者当前 shell 没加载更新后的环境变量。常见现象是执行 pnpm --version 报 command not found，但 npm list -g pnpm 显示已安装。
- 先确认全局安装路径：
npm config get prefix，通常返回类似/home/username/.npm-global或/usr/local - 检查该路径下的
bin是否在$PATH里：echo $PATH | grep -o "/.*npm.*/bin" - 若没命中，把
$(npm config get prefix)/bin加进~/.bashrc或~/.zshrc（看用的 shell），然后source ~/.bashrc - 别用
sudo npm install -g pnpm—— 权限混乱会导致后续pnpm store权限错误
Node.js 版本太低：pnpm v9 要求 Node.js ≥ 18.17
装完 pnpm 却提示 ERR_PNPM_UNSUPPORTED_NODE_VERSION，大概率是系统自带或旧版 Node.js。Ubuntu/Debian 默认源里的 nodejs 包往往卡在 12.x 或 16.x，不够用。
- 查当前版本：
node --version，低于v18.17.0就得换 - 推荐用
volta管理（比 nvm 更轻、无 shell hook）：curl https://get.volta.sh | bash，然后volta install node@18.18.2 - 避免用
apt install nodejs—— 官方包不更新，且npm版本也老旧，容易和 pnpm 的store格式冲突 - 验证：
node --version && npm --version都要能正常输出，且npm版本 ≥ 9.6（pnpm v9 依赖较新 npm 内部 API）
pnpm store 权限被拒：Operation not permitted 错误
首次运行 pnpm install 时卡住，日志末尾出现 EPERM: operation not permitted，多见于 WSL2 或某些 Linux 发行版（如 Fedora Silverblue），本质是 pnpm 默认 store 路径（~/.local/share/pnpm/store）被文件系统或 SELinux 限制写入。
- 临时绕过：加
--no-store，但失去硬链接优势，磁盘占用翻倍 - 正确做法：改 store 路径到用户可完全控制的目录，比如
~/.pnpm-store，并设为全局配置：pnpm config set store-dir ~/.pnpm-store - 如果用了
volta或nvm，确保PNPM_HOME和PNPM_STORE_DIR环境变量没冲突（优先级：命令行 > 环境变量 > 配置文件） - 别手动
chown -R原 store 目录 —— pnpm 启动时会校验 store 完整性，权限乱了反而报ERR_PNPM_STORE_IS_LOCKED
为什么不用 npm / yarn？pnpm 在 Linux 上的真实优势场景
不是为了“新”，而是解决具体问题：多项目共存、CI 构建速度、磁盘空间紧张。Linux 开发者常同时维护 5+ Node.js 服务，每个都 node_modules 占 200MB+，传统方式很快吃光 SSD。
-
pnpm的硬链接 store 让 10 个项目共享同一份依赖二进制，实际node_modules目录体积压缩到原来的 1/5～1/3 - CI 中
pnpm install --frozen-lockfile比npm ci快 30%～50%，尤其在小内存 VPS 上更稳（内存占用低 40%） - 注意：
pnpm不兼容某些硬编码node_modules路径的工具（如老版electron-builder），遇到Cannot find module先查pnpm help link看是否需显式pnpm link
真正麻烦的是跨用户共享 store 和 systemd service 里运行 pnpm —— 这俩地方的权限和环境变量隔离比想象中严，别图省事直接用 root 装，出问题更难 debug。
