VSCode调试器报“Cannot find runtime 'node'”或断点失效，根本原因是其不继承fnm切换后的Node.js路径，必须在launch.json中显式配置runtimeExecutable字段指向fnm安装的具体node二进制文件（如Windows下"C:UsersyournameAppDataRoaming nm ersions8.20.2in ode.exe"），而非依赖shell环境变量或写"node"。
VSCode 里 node 命令能跑，但调试器报 Cannot find runtime 'node' 或断点不生效？不是 VSCode 配置错了，是它压根没读取 fnm 切换后的 Node.js 路径——调试器不走 shell 环境变量，只认 launch.json 或系统 PATH。
为什么 VSCode 内置终端能用 fnm，但调试器找不到 node
VSCode 启动时不会自动加载 PowerShell 的 $PROFILE 或 Bash 的 .bash_profile，所以 fnm env --use-on-cd | Out-String | Invoke-Expression 这类初始化逻辑只在交互式终端生效，对调试器无效。调试器启动的是独立进程，不继承你手动执行过的 fnm use 结果。
-
fnm use 18.20.2只影响当前终端会话，不修改全局 PATH - VSCode 调试器默认从系统 PATH 查找
node，而fnm安装的版本默认放在$FNM_DIR/versions/下，不在系统 PATH 中 - 即使你在终端里运行过
fnm use，重启 VSCode 后调试器仍会 fallback 到旧版本或报错
launch.json 必须显式指定 runtimeExecutable
别依赖“自动发现”，直接告诉调试器用哪个 node 二进制文件。路径必须精确到可执行文件，且不能含波浪号 ~（Windows 不识别）。
- 先查当前项目实际使用的 Node.js 路径：
fnm which 18.20.2（替换为你项目要求的版本） - Windows 示例路径：
"runtimeExecutable": "C:\Users\yourname\AppData\Roaming\fnm\versions\18.20.2\bin\node.exe" - macOS/Linux 示例路径：
"runtimeExecutable": "/Users/yourname/.fnm/versions/18.20.2/bin/node" - 不要写
"runtimeExecutable": "node"—— 这会让调试器忽略fnm，走系统 PATH
配合 .node-version 实现自动切换 + 调试兼容
fnm 支持自动读取项目根目录下的 .node-version 文件，但 VSCode 调试器不会主动触发这个行为。你需要把二者桥接起来。
- 确保项目根目录有
.node-version文件，内容仅一行：18.20.2 - 在 VSCode 的
settings.json中加这一行："terminal.integrated.env.windows": {"FNM_MULTISHELL_PATH": "${env:FNM_DIR}"}（仅 Windows；macOS/Linux 用terminal.integrated.env.osx或env.linux） - 更稳妥的做法：在
launch.json的每个 configuration 里都配runtimeExecutable，而不是指望环境变量自动生效 - 如果项目同时用
pnpm或yarn，注意它们的node_modules/.bin里可能有封装脚本，调试时别误选这些包装器
最易被忽略的一点：VSCode 的“重新加载窗口”（Developer: Reload Window）不会刷新 fnm 的 shell 初始化逻辑——它只重载插件和设置。真正生效的方式只有两个：从终端启动 VSCode（code .），或者手动在 launch.json 里填死路径。后者看似啰嗦，却是唯一稳定跨平台的方案。
