调试器里运行的 Node 版本与终端中 node -v 显示的结果不一致，这个问题曾困扰过不少开发者。根本原因在于，VSCode 调试器启动时缓存的是当时的 PATH 环境变量，而非你当前终端执行 nvm use 之后的环境设置。即使你在终端中切换到了 v18，按下 F5 启动调试时，它仍然会调用旧版本的 node——因为那一刻 PATH 并未被更新。
重启 VSCode 才能生效，这并非 nvm 切换失败，而是因为 VSCode 的 GUI 进程根本没有加载你的 shell 初始化脚本。 它在启动时便固化了整套环境变量（包括 PATH 和 NVM_BIN），之后你在集成终端中执行 nvm use，并不会影响已经启动的调试器或任务进程。
为什么终端中 node -v 显示正确，但按 F5 调试时仍使用旧版本？
VSCode 的 Node.js 调试器（type: "node"）默认不会继承集成终端的环境变量。它直接查阅启动时缓存的 PATH，而这个 PATH 是 VSCode 启动那一刻从父进程（GUI）继承而来的——与你当前终端里 nvm use 的结果毫无关联。
常见表现：
- 在集成终端中执行
which node返回~/.nvm/versions/node/v18.17.0/bin/node，但 F5 调试后process.version输出却是v16.20.2 - 调试时出现
Cannot find module 'node:fs'错误（Node.js 16 不支持node:前缀，说明实际运行的是旧版） launch.json中未配置runtimeExecutable，调试器就会在PATH中查找第一个node，通常指向系统自带或旧的 nvm alias
terminal.integrated.inheritEnv 必须设置为 true 并彻底重启 VSCode
这一步最容易被忽视。VSCode 默认不继承 shell 环境，即使你在 ~/.zshrc 中写入了 source ~/.nvm/nvm.sh，GUI 进程依然无法识别 nvm 命令。
操作步骤：
- 打开设置（
Cmd + ,），搜索terminal.integrated.inheritEnv，勾选启用 - 务必完全退出 VSCode（macOS 上使用
Cmd + Q，而非仅关闭窗口），再重新打开 - 重启后，在集成终端中运行
echo $NVM_BIN，确认有输出；再执行nvm current查看是否显示预期版本 - 若仍无输出，请检查 shell 类型：macOS 默认是
zsh，确保~/.zshrc中包含export NVM_DIR="$HOME/.nvm"和[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
launch.json 中 runtimeExecutable 应使用 ${env:NVM_BIN}/node
硬编码路径（例如 "runtimeExecutable": "/Users/xxx/.nvm/versions/node/v18.17.0/bin/node"）换到其他机器就会失效。更可靠的做法是依赖环境变量间接引用：
"runtimeExecutable": "${env:NVM_BIN}/node"
但前提是 ${env:NVM_BIN} 必须能够被正确展开——这又回到了上一步：VSCode 必须继承该变量。验证方法：
- 在集成终端中运行
echo $NVM_BIN，有输出才说明变量已就绪 launch.json中的拼写必须准确：env全小写、冒号后空格可选但引号必须闭合、斜杠方向为 Unix 风格- 如果
${env:NVM_BIN}展开为空，调试器会报错Cannot resolve runtimeExecutable
真正让人卡住的并非配置本身有多复杂，而是「修改设置后没有完全退出 VSCode」以及「误以为 nvm use 能全局生效」这两个操作之间的认知差距。环境变量并非广播信号，它只对新启动的进程有效——而 VSCode 的调试器，正是那个未能接收到新信号的老进程。
