VSCode集成终端无法识别pnpm CLI，但Mac默认终端可正常使用

问题分析 #

更新pnpm和Node.js版本后，VSCode集成终端执行任何pnpm开头的命令都会报错找不到CLI文件，但Mac默认终端可正常运行。对比两者的$PATH可发现核心差异：

• VSCode终端中/Users/<user>/Library/pnpm路径位置靠后，还存在重复的nvm/brew路径、Copilot调试命令路径
• Mac默认终端中/Users/<user>/Library/pnpm处于PATH最前端，优先级最高

这种PATH顺序差异导致VSCode终端优先查找其他路径的工具，无法正确识别pnpm的shim文件，最终触发找不到CLI的报错。

解决方案 #

1. 强制提升pnpm路径在VSCode终端的优先级 #

打开VSCode设置（快捷键Cmd+,），搜索terminal.integrated.env.osx，添加以下配置（替换<user>为你的系统用户名）：

"terminal.integrated.env.osx": {
  "PATH": "/Users/<user>/Library/pnpm:$PATH"
}

2. 让VSCode终端加载完整的zsh登录环境 #

针对新版VSCode，搜索terminal.integrated.profiles.osx，配置zsh以登录shell模式启动：

"terminal.integrated.profiles.osx": {
  "zsh": {
    "path": "/bin/zsh",
    "args": ["-l"]
  }
},
"terminal.integrated.defaultProfile.osx": "zsh"

旧版VSCode可直接搜索terminal.integrated.shellArgs.osx，将参数设置为["-l"]。

3. 重新生成pnpm Shim文件（可选） #

如果上述步骤无效，在Mac默认终端执行以下命令重新生成pnpm的shim文件：

pnpm setup

执行完成后重启VSCode，再测试pnpm命令。

内容的提问来源于stack exchange，提问作者crevulus