解决切换 Node 版本后 “pnpm 不是内部或外部命令”问题
在使用 Node.js 开发过程中，我们常会借助 nvm（Node Version Manager）灵活切换不同的 Node 版本以适配项目需求。但最近在从 Node 20.10.0 版本切换到 20.19.0 版本后，执行pnpm -v命令时，却遭遇了 “'pnpm' 不是内部或外部命令，也不是可运行的程序” 的报错，想必不少开发者也遇到过类似情况。下面就详细拆解问题原因，并给出具体的解决步骤。
一、问题复现：清晰定位场景
先明确问题发生的完整流程，方便大家对照排查：
初始环境：已安装 Node.js 20.10.0 版本，通过
npm install -g pnpm命令全局安装了 pnpm，此时执行pnpm -v能正常显示版本号，pnpm 可正常使用。版本切换：因项目需求，使用 nvm 安装了 Node.js 20.19.0 版本（命令：
nvm install 20.19.0），并切换到该版本（命令：nvm use 20.19.0）。报错触发：切换到 Node 20.19.0 后，再次执行
pnpm -v，终端直接抛出 “'pnpm' 不是内部或外部命令，也不是可运行的程序” 错误，pnpm 无法调用。二、问题根源：理解依赖安装逻辑
要解决这个问题，首先得搞懂 “为什么切换 Node 版本后 pnpm 会失效”。核心原因在于全局依赖的安装路径与 Node 版本绑定：
当我们通过
npm install -g pnpm安装 pnpm 时，npm 会将 pnpm 的可执行文件、相关依赖包，默认安装到当前使用的 Node 版本对应的目录中。
步骤 3：复制 pnpm 核心依赖
除了可执行命令，还需要复制 pnpm 的核心依赖包（存放在node_modules中）：
步骤 4：验证是否解决
完成上述复制后，打开新的终端（避免旧环境变量影响），执行以下命令验证：
在 Node 20.10.0 版本下安装 pnpm，所有与 pnpm 相关的文件（包括
pnpm.cmd可执行命令、node_modules中的 pnpm 依赖），都会存放在 nvm 管理的 Node 20.10.0 版本文件夹内（通常路径类似：C:\Users\你的用户名\.nvm\v20.10.0）。当通过 nvm 切换到 Node 20.19.0 版本后，系统会将 Node 的环境变量指向 20.19.0 版本的目录（路径类似：
C:\Users\你的用户名\.nvm\v20.19.0）。而这个新的 20.19.0 版本目录中，并没有之前安装的 pnpm 相关文件，所以执行pnpm命令时，系统找不到对应的可执行程序，自然就会报错。三、解决方案：迁移 pnpm 相关依赖
既然问题根源是 pnpm 依赖存放在旧 Node 版本目录，那最直接的解决方法就是将旧版本（20.10.0）中的 pnpm 相关文件，复制到新版本（20.19.0）的对应目录中。具体步骤如下，以 Windows 系统为例（Mac/Linux 路径逻辑类似，只需对应调整路径即可）：
步骤 1：找到 Node 版本目录
首先打开 nvm 管理的 Node 版本存放路径，默认路径为：
C:\Users\【你的用户名】\.nvm（如果安装 nvm 时自定义了路径，就进入自定义的路径，核心是找到
v20.10.0和v20.19.0两个文件夹）在这个目录下，你会看到两个关键文件夹：
v20.10.0（旧版本，有 pnpm）和v20.19.0（新版本，无 pnpm）。
步骤 2：复制 pnpm 可执行命令
进入旧版本（v20.10.0）的
bin目录：C:\Users\你的用户名\.nvm\v20.10.0\bin（如果没有
bin目录，直接在v20.10.0根目录下找，通常可执行命令会直接放在根目录）在该目录中，找到与 pnpm 相关的可执行文件，通常包括：
pnpm.cmd、pnpx.cmd（如果有）。
将这所有相关文件复制，粘贴到新版本（v20.19.0）的对应目录中：
C:\Users\你的用户名\.nvm\v20.19.0\bin（同样，若新版本无
bin目录，直接粘贴到v20.19.0根目录）进入旧版本（v20.10.0）的
node_modules目录：C:\Users\你的用户名\.nvm\v20.10.0\node_modules在该目录中，找到名为
pnpm的文件夹（这是 pnpm 的核心依赖），将整个pnpm文件夹复制。
进入新版本（v20.19.0）的
node_modules目录：C:\Users\你的用户名\.nvm\v20.19.0\node_modules将复制的
pnpm文件夹粘贴到这个目录中，完成依赖迁移。先确认当前 Node 版本是否为 20.19.0：
node -v若显示
v20.19.0，说明版本切换正确。再执行 pnpm 版本查询命令：
pnpm -v如果能正常显示 pnpm 的版本号（例如
8.15.0），则说明问题已解决，pnpm 可正常使用。