VSCode中node/npm命令找不到及断点灰掉，主因是四个运行时（终端、调试器、插件主机、code-runner）各自加载的Node路径不一致；根本在于环境变量快照固化——VSCode启动时冻结shell环境，nvm切换后主进程不自动刷新，需彻底重启或重载shell环境。
VSCode 里 node 命令找不到、npm 报错、断点灰掉，绝大多数不是 Node 没装好，而是四个运行时（终端、调试器、插件主机、code-runner）各自认的 node 不一致——路径冲突的本质是环境快照固化，不是配置没写对。
为什么 VSCode 终端里 node -v 显示旧版本？
这不是 PATH 写错了，而是 VSCode 启动时冻结了 shell 的环境变量快照。你用 nvm use v18.20.4 切换后，主进程不会自动刷新，旧 PATH 仍在内存里。
- Windows：任务管理器中结束所有
Code.exe进程，再重新启动 - macOS：Dock 右键 VSCode → Quit（不是关窗口），再从终端执行
code . - nvm-windows 用户：
nvm use后，必须在 VSCode 中执行Terminal: Reload Shell Environment（Ctrl+Shift+P） - 验证方式：在 VSCode 终端里运行
which node，输出应为类似~/.nvm/versions/node/v18.20.4/bin/node
launch.json 里设了 runtimeExecutable 还是报错？
这个字段只控制调试会话的主进程，不影响扩展主机（Extension Host）和含原生模块的插件。常见症状是断点灰掉、Cannot find module './build/Release/xxx.node'。
- 插件实际运行在 VSCode 内置 Electron 的 Node 上，版本由
process.versions.node和process.versions.napi决定 - VS Code 1.90+ 对应
Node.js 22.4.0，napi_build_version=9；若你系统node是 v20.x（napi=8），npm rebuild生成的二进制无法加载 - 重编译原生模块时，必须显式指定：
--napi-build-version=9 --runtime=electron --target=34.0.0 - 重编译前先清空插件目录下的
node_modules/.pnpm和out/，否则旧缓存优先被加载
WSL2 下 VSCode 终端找不到 g++ 或 node？
不是没装，而是 Windows 的 PATH 被追加到 Linux PATH 末尾，导致 which node 返回 /mnt/c/Program Files/nodejs/node.exe ——这个路径根本不能在 Linux 下执行。
- 在 VSCode 设置中搜索
terminal.integrated.shellArgs，设为["-l"]（小写 L） - 关闭所有已打开的集成终端面板（不只是标签页，要点右上角 × 关整个面板）
- 按 Ctrl+` 新建终端，此时
echo $PATH | tr ':' '\n' | grep mnt应无输出 - 在
~/.bashrc开头添加剥离逻辑：export PATH=$(echo $PATH | sed 's|:/mnt/[^:]*||g')，再重建PATH
中文路径下 Unable to resolve non-existing file 怎么办？
Windows 开启「Beta 版：使用 Unicode UTF-8」会导致 Node.js 子进程对中文路径二次编码，VSCode 收到的是乱码字符串。
- 打开「控制面板 → 区域 → 管理 → 更改系统区域设置」，取消勾选「Beta 版：使用 Unicode UTF-8」
- 重启电脑（仅改设置不重启无效），CMD 中运行
chcp应显示936（GBK） - 启动工作区时，不要双击资源管理器里的中文路径文件，改用
cd C:\项目 & code . - 路径中避免中文括号、顿号、全角空格——这些比汉字更容易触发参数截断
最常被忽略的点是：ABI 兼容性看的不是 Node.js 版本号，而是 process.versions.napi 和插件编译时声明的 napi_build_version 是否完全一致。差 1 都不行。
