如何解决 nvm 管理的 Node.js 版本与 pnpm 版本不兼容的问题？

当使用 nvm 管理 Node.js 版本时遇到与 pnpm 不兼容的问题，可通过以下步骤解决：

1. 检查当前 Node.js 版本

node -v

确保当前使用的 Node.js 版本符合项目要求

2. 检查 pnpm 版本

pnpm -v

确认 pnpm 版本是否支持当前 Node.js 版本（参考 pnpm 兼容性文档）

3. 重新安装 pnpm

卸载并重装 pnpm 可解决版本冲突：

npm uninstall -g pnpm
npm install -g pnpm@latest # 安装最新兼容版本

4. 清除缓存

pnpm store prune # 清理无效依赖
rm -rf node_modules # 删除旧模块

5. 版本锁定

在项目根目录创建 .npmrc 文件指定 pnpm 版本：

engine-strict = true
pnpm_version = 8.6.0 # 指定兼容版本

6. 验证环境

nvm use 18.0.0 # 切换 Node 版本
pnpm install –frozen-lockfile # 严格安装

常见错误处理

• ERR_PNPM_UNSUPPORTED_ENGINE： 升级 pnpm 或降级 Node.js $$\text{要求}:\text{pnpm}\ge \mathrm{7.17.0}\iff \text{Node.js}\ge 16.14$$
• 文件路径冲突： 检查系统 PATH 是否包含多个 pnpm 路径

提示：使用 pnpm env use –global 18.0.0 可直接管理 Node 环境，避免 nvm 冲突（需 pnpm ≥ 7.0）