vscode终端找不到node命令，根本原因是启动时未继承shell配置或系统path未包含node.js路径；macos/linux需从终端执行code启动并重载~/.zshrc，windows需检查系统环境变量path是否含node安装目录，验证必须在vscode终端运行node -v。
VSCode终端找不到node命令？先确认PATH继承是否生效
根本不是VSCode设置问题，而是它启动时没加载你的shell配置（如~/.zshrc）或系统PATH压根没写入Node.js路径。macOS/Linux下从Dock或Spotlight启动VSCode，进程不会读~/.zshrc；Windows则常因安装时漏选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；有但无效，大概率是路径含空格、斜杠方向错，或被其他软件覆盖 - 更稳妥做法：卸载Node.js，重装LTS版，安装时务必勾选
Add to PATH，且路径避开中文和空格
terminal.integrated.env.*配置能绕过系统PATH限制
当你没权限改系统环境变量，或需要为单项目指定Node版本（比如用nvm管理多个版本），就得靠VSCode自己的环境变量注入机制。它不修改系统PATH，而是在终端启动时把指定路径“前置”进环境变量，优先级高于系统原有PATH。
- 全局生效（所有项目都用这个Node）：在VSCode设置中搜Env，点开
terminal.integrated.env.windows（macOS/Linux对应.linux或.osx），编辑settings.json - 局部生效（仅当前项目）：在项目根目录建
.vscode/settings.json，内容同上。注意路径中的C:/path/to/your/node要替换成你实际解压或安装的node.exe所在目录（不是node_modules） - Windows路径用正斜杠
/或双反斜杠\均可，但不能混用单反斜杠；${env:PATH}必须保留，否则会丢掉系统原有PATH，导致npm、git等命令失效 - 改完保存后，必须重启VSCode（不是重载窗口），否则新PATH不加载
launch.json里program字段填什么才不会启动失败
VSCode调试器靠program字段定位入口文件，填错就直接报Cannot find module或空转不执行：
- 默认生成的是
"${workspaceFolder}index.js"（Windows）或"${workspaceFolder}/index.js"（macOS/Linux），但多数项目用的是app.js或src/index.js - 推荐写成
"${workspaceFolder}/app.js"并确保该文件真实存在；若想临时调试当前打开的文件，改用"${file}"（注意不是${fileBasename}） - 如果用了TypeScript或ESM，
program必须指向编译后JS文件（如dist/index.js），而不是源码；否则会报ERR_REQUIRE_ESM -
runtimeExecutable和终端PATH是两套逻辑：即使node -v在终端里跑通了，launch.json里仍可能报Cannot find runtime 'node'
断点不触发？type和request字段漏一个就静默失效
VSCode不会自动识别你写的JS文件该用什么调试器。必须显式声明：type: "node"和request: "launch"（启动新进程）或request: "attach"（连已有进程）。漏掉任一字段，整个配置就静默失效。
-
request: "launch"适用于直接运行入口文件，比如node app.js；此时program必须指向一个可执行的JS文件路径，不能是npm或ts-node命令 -
request: "attach"适用于已用node --inspect-brk app.js启动的服务；必须确保port和命令行里的一致（默认9229），且address是"localhost"（Docker内需设为"0.0.0.0"） - 别手写
type: "pwa-node"——虽然新版推荐，但老项目或某些CI/remote场景下容易fallback失败，优先用"node" - Node版本必须≥14：VSCode调试器对
async_hooks等底层机制有依赖，低于14可能导致异步调用栈无法挂起
node -v能跑，launch.json也写了program，但断点就是不进——这时候得回头再查一遍type和request有没有拼错，program指向的文件是否存在，以及node是不是真的被调试器看见了，而不是终端“假装”看见。
