升级Node.js v9后VSCode调试时Mocha找不到ts-node/register

我之前也碰到过几乎一模一样的情况，升级Node版本后VSCode调试就掉链子，外部跑测试却完全正常——核心原因基本都是VSCode的调试进程没正确使用nvm切换后的Node环境，导致它找不到项目本地安装的ts-node模块。下面是几个亲测有效的解决办法：

1. 强制VSCode使用nvm的Node版本 #

VSCode默认可能会用系统全局的Node，而非nvm管理的版本，你可以手动指定：

• 打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入>Node: Select Interpreter
• 在弹出的列表里选择nvm安装的v9.x版本（路径一般是~/.nvm/versions/node/v9.x/bin/node）
• 重启VSCode让设置生效，再尝试调试

2. 修改launch.json的ts-node路径为本地依赖 #

有时候调试配置里的ts-node/register会被解析成全局模块，但你可能只在项目本地安装了ts-node。修改.vscode/launch.json的Mocha配置：

{
  "type": "node",
  "request": "launch",
  "name": "Mocha Tests",
  "program": "${workspaceFolder}/node_modules/mocha/bin/_mocha",
  "args": [
    "--require", "./node_modules/ts-node/register", // 改用项目本地的ts-node路径
    "${workspaceFolder}/test/**/*.spec.ts"
  ],
  "console": "integratedTerminal",
  "internalConsoleOptions": "neverOpen"
}

3. 清除依赖缓存后重新安装 #

升级Node版本后，旧的依赖缓存可能和新Node版本不兼容，执行以下命令重置依赖：

rm -rf node_modules
rm package-lock.json # 用yarn的话删yarn.lock
npm install

4. 让VSCode终端继承nvm环境 #

如果调试时用的是VSCode集成终端，确保它能加载nvm的环境配置：

• 打开VSCode设置（Ctrl+, / Cmd+,），搜索terminal.integrated.shellArgs
• 对应你的shell（bash/zsh）添加-l参数（登录shell模式），这样终端会加载~/.bashrc/~/.zshrc里的nvm配置，保证Node版本和外部终端一致

为什么外部运行正常？ #

因为你在终端里已经通过nvm切换到了v9版本，终端环境加载了正确的Node路径和模块查找路径；但VSCode的调试进程默认可能脱离了这个环境，用了全局Node或者没读取nvm的配置，自然找不到本地的ts-node模块。

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