VSCode调试器无法找到Node.js的根本原因是其不继承fnm切换后的路径，必须在launch.json中显式配置runtimeExecutable字段指向fnm安装的具体node二进制文件，如Windows下"C:UsersyournameAppDataRoaming nm ersions8.20.2in ode.exe"。
VSCode 本身不管理 Node.js 版本，FNM 也不自动注入到 VSCode 调试器中——终端能用 node，调试器报 Cannot find runtime 'node' 或断点失效，几乎全是这个原因。
为什么 VSCode 终端能用 fnm，但调试器找不到 node
VSCode 启动时不会执行 PowerShell 的 $PROFILE 或 Bash 的 .bashrc，所以 fnm env --use-on-cd | Out-String | Invoke-Expression 这类初始化只在交互式终端生效。调试器启动的是干净子进程，不继承你手动 fnm use 的结果，也不读取 shell 配置里的 PATH。
它默认只查系统 PATH，而 fnm 安装的版本（如 $FNM_DIR/versions/18.20.2/bin/node）不在系统 PATH 中。
-
fnm use 18.20.2只影响当前终端会话，重启 VSCode 后无效 - 即使你在终端里运行过
fnm use，调试器仍 fallback 到旧版或直接报错 -
runtimeVersion字段在launch.json中对 fnm 无效（那是给 nvm 设计的）
必须在 launch.json 中显式配置 runtimeExecutable
别依赖“自动发现”，直接告诉调试器用哪个二进制文件。路径必须精确、完整、不含 ~（Windows 不识别波浪号）。
先查实际路径：fnm which 18.20.2（把 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 - 路径中的反斜杠在 JSON 里要双写（
\），单写会解析失败 - 每个
configuration都得单独配，不能只在configurations外层写一次
让 .node-version 文件真正起作用
fnm 支持自动读 .node-version，但 VSCode 调试器不会触发它。你需要手动桥接。
确保项目根目录有 .node-version 文件，内容仅一行：18.20.2
然后在 launch.json 的每个 configuration 里都写上对应的 runtimeExecutable，而不是指望环境变量同步。
- 不要混用
.nvmrc和.node-version：fnm 默认只认后者；nvm 只认前者 - 如果项目用了
volta，它的.tool-versions与 fnm 互不识别，选一个工具并坚持用到底 - VSCode 内置终端可配合
terminal.integrated.env.windows注入FNM_MULTISHELL_PATH，但这对调试器无直接影响
容易被忽略的细节
最麻烦的不是配置本身，而是不同环节读取环境的方式根本不一致：终端靠 shell 初始化，调试器靠 runtimeExecutable 显式指定，任务靠 tasks.json 显式调用命令，ESLint/TypeScript Server 等扩展又各自找自己的 node 路径。
你改了 launch.json，不代表终端里 npm run dev 就自动用了新版本——那还得靠 fnm use 或 .node-version + 手动执行 来保证。
