vscode中node命令找不到、调试器报“cannot find runtime 'node'”等问题，根本原因是vscode启动时未继承shell的path环境变量：macos/linux因dock启动不加载~/.zshrc，windows因安装漏选“add to path”导致c:program files odejs未写入系统变量；验证方式唯一——在vscode内置终端执行node -v，无输出则所有后续配置均无效。
VSCode 里 node 命令找不到、调试器报 Cannot find runtime 'node'、npm 或 nodemon 在终端里失效——这些问题几乎全出在环境变量继承逻辑上，不是设置没点对，而是 VSCode 启动时根本没拿到你 shell 里已生效的 PATH。
VSCode 终端为啥执行不了 node -v
macOS/Linux 下从 Dock 或 Spotlight 启动 VSCode，进程不加载 ~/.zshrc；Windows 下 Node 安装时漏选 Add to PATH，系统变量里压根没 C:Program Files
odejs 这一行。验证只有一种方式：在 VSCode 内置终端（Ctrl + `）里直接输 node -v，没输出就别往下配 launch.json。
- macOS/Linux：改完
~/.zshrc后必须彻底退出所有 VSCode 窗口，再从终端执行code --no-sandbox .启动 - Windows：打开「系统属性 → 高级 → 环境变量」，检查「系统变量」的
Path是否含C:Program Files odejs；有但无效，大概率是路径含空格或斜杠方向错（比如写成C:Program Files odejs而非C:Program Files odejs） - 最稳妥解法：卸载 Node.js，重装 LTS 版，安装时务必勾选
Add to PATH，且路径避开中文和空格
terminal.integrated.env.* 怎么安全注入 PATH
当你用 nvm 切换 Node 版本，或没权限改系统变量时，就得靠 VSCode 自己的环境变量注入机制。它不覆盖系统 PATH，而是在终端启动时把指定路径“前置”进去，优先级更高。
- 全局生效：在 VSCode 设置中搜
Env，编辑settings.json，填入"terminal.integrated.env.windows"（Windows）或"terminal.integrated.env.linux"（Linux/macOS） - 局部生效：在项目根目录建
.vscode/settings.json，内容同上，但路径要指向你实际的node.exe所在目录（不是node_modules） - 路径写法：Windows 用正斜杠
/或双反斜杠\，不能混用单反斜杠；${env:PATH}必须保留，否则会丢掉系统原有命令（如git、npm） - 改完必须重启 VSCode（不是重载窗口），否则新 PATH 不加载
launch.json 里 runtimeExecutable 和 program 别乱配
即使终端里 node -v 跑得通，调试器仍可能报错，因为它的查找逻辑和终端完全独立。尤其用了 nvm、fnm 或 volta 时，默认不走系统 PATH。
-
runtimeExecutable字段如果存在，就优先用它指定的路径；若写死为~/.nvm/versions/node/v18.17.0/bin/node，而你当前用的是 v20，就会直接失败 -
program必须指向一个能被node直接执行的 JS 文件（如${workspaceFolder}/dist/server.js），不能是.ts或未编译源码 - TypeScript 项目需确保
tsconfig.json含"sourceMap": true，且.js.map和.js在同一目录 - ESM 项目必须在
package.json中声明"type": "module"，否则调试器按 CommonJS 解析，import全报错
用 code-runner 跑脚本容易踩哪些坑
这个插件默认命令极简：node $fileName，不处理编码、模块类型、输入流，也不读 package.json，所以中文路径、import、process.stdin 都会出问题。
- Windows 中文路径乱码：在设置里搜
code-runner.executorMap，把javascript对应值改成"node -r utf-8 $fileName" - 报
Cannot use import statement outside a module：先确认项目有package.json且含"type": "module"，再把 executor 改成"node --experimental-specifier-resolution=node $fileName" - 遇到
process.stdin就假死：这是code-runner的固有限制，它不支持交互式输入；换用内置终端手动运行，或改用 F5 调试模式
真正复杂的地方不在配置项本身，而在 VSCode 启动时的环境继承链：shell 初始化文件 → 系统 PATH → VSCode 进程环境 → 终端 session → 调试器 runtime。任一环节断开，node 就变成不可见的黑盒。每次怀疑配置错了，先回到 Ctrl + ` 里敲 node -v —— 它不输出，后面所有操作都是空中楼阁。
