VSCode调试Node.js失败主因是node/npm未被系统PATH正确识别：Windows需重装并勾选“Add toPATH”或手动添加C:\Program Files\nodejs；macOS/Linux需确保~/.zshrc含nvm配置并从终端执行code .启动。
node -v 和 npm -v 报错，VSCode 调试直接失败
这不是 VSCode 的问题，而是系统根本没认出 node。VSCode 内置终端或调试器启动时，会从系统 PATH 里找 node 和 npm，找不到就报 Cannot find runtime 'node' 或类似错误。
- Windows 安装时务必勾选 Add to PATH；漏了就得手动把
C:\Program Files\nodejs（或你实际安装路径）加进系统环境变量Path，然后关掉所有终端窗口重开 - Windows 别装在含中文、空格或括号的路径下（比如
D:\我的软件\nodejs），npm会静默崩溃，连错误都不报 - macOS/Linux 用
nvm的，确认source ~/.nvm/nvm.sh已写入~/.zshrc（或~/.bash_profile），且新开终端已执行过该文件（可运行command -v nvm验证）
VSCode 调试器不工作，但 node 命令行能跑
常见于误以为“能跑 node index.js 就等于能调试”。VSCode 调试依赖 npm 启动逻辑，npm -v 必须成功，否则 launch.json 里任何配置都无效。
- 不要跳过在系统终端（不是 VSCode 内置终端）里执行
node -v和npm -v—— 这才是真实环境 - VSCode 内置终端可能继承了错误的 shell 环境（比如 zsh 配置没加载 nvm），导致它能跑
node但调试器不能，务必以系统终端为准 - 调试前先确保项目根目录有
package.json（哪怕只是npm init -y生成的），否则某些 launch 配置会异常退出
launch.json 里 program 改成 npm start 就黑屏没输出
默认生成的 "program": "${file}" 只适合单文件调试。一旦换成 npm 脚本，必须显式指定控制台行为，否则输出被吞掉，断点也不触发。
- 要调试
npm start，配置里得加这两项："console": "integratedTerminal"和"program": "npm"，再设"args": ["start"] - 用
nodemon？别把"program"指向nodemon—— VSCode 调试器不支持热替换。正确做法是命令行先跑nodemon --inspect-brk index.js，然后在launch.json里配"type": "node"+"request": "attach"+"port": 9229 -
port值必须和--inspect-brk输出的实际端口一致（默认是 9229，不是 92）
装了一堆 Node.js 插件反而调试失败
VSCode 自带 Node.js 调试支持，Node.js Extension Pack 或 Debugger for Node.js 这类插件在新版中已废弃，装了可能劫持调试流程，导致 F5 启动失败或断点失效。
- 卸载所有名字含 “Node.js”、“Debugger”、“Extension Pack” 的插件，只留 ESLint、Prettier 这类辅助工具
- 验证方式：按
Ctrl+Shift+P输入Debug: Open Configuration，选择Node.js → Current File，看生成的launch.json是否含"type": "node"—— 这才是原生支持 - 如果插件还在后台注入自定义调试适配器，VSCode 底部状态栏会显示非标准的调试图标（比如带齿轮的 Node 图标），此时必须禁用对应插件
