VS Code中使用NPM SCRIPTS时NPM未找到问题咨询

我遇到过好几个开发者碰到这种情况——命令行里跑npm run test好好的，到VS Code的NPM Scripts面板点运行就失败，明明提示运行目录一致。下面几个排查方向应该能帮到你：

• 核对VS Code的终端环境变量
  VS Code的集成终端有时候不会完全继承系统/手动命令行的环境变量，尤其是用了nvm、n这类Node版本管理工具时。你可以：

  1. 在VS Code集成终端里执行 echo $PATH（Mac/Linux）或 echo %PATH%（Windows）
  2. 在手动打开的命令行（比如你能正常跑脚本的那个）里执行同样命令
  3. 对比两者的输出，如果PATH不一样，试试从命令行启动VS Code：在项目根目录打开命令行，输入 code .，这样VS Code会继承当前命令行的环境变量，再试试运行脚本。

• 检查VS Code的终端配置
  打开VS Code设置（快捷键Ctrl+,/Cmd+,），搜索terminal.integrated.defaultProfile，确认选中的终端和你手动使用的是同一个（比如Windows选Cmd还是PowerShell，Mac选zsh还是bash）。另外看看有没有配置terminal.integrated.env.*相关项，这些设置可能会覆盖npm的路径或其他环境变量。

• 给脚本加调试输出，核对环境
  虽然提示运行目录一致，但可以给你的test脚本加几行调试命令，比如修改package.json里的脚本：

  "scripts": {
    "test": "pwd && which npm && 你的原有测试命令" // Mac/Linux
    // 或者Windows下："test": "cd && where npm && 你的原有测试命令"
  }
  

  分别在命令行和VS Code面板运行npm run test，对比输出的npm路径和当前目录，就能看出是否有环境差异。

• 清理缓存并重启VS Code
  有时候缓存会搞出奇怪的问题：

  1. 关闭VS Code，备份并删除项目根目录下的.vscode文件夹
  2. 执行npm cache clean --force清理npm缓存，再重新安装依赖npm install
  3. 重启VS Code并重新打开项目，再尝试运行脚本

• 排查权限或沙箱限制（Mac/Linux）
  如果你的VS Code是从应用商店安装的，可能会有沙箱限制，导致无法访问某些路径或工具。试试从官网下载VS Code的独立版本，或者用命令行code .启动VS Code，绕开沙箱限制。

内容的提问来源于stack exchange，提问作者José Miguel