VSCode调试Node.js的前提是内置终端能识别node和npm，否则报spawn node ENOENT；需确保PATH正确配置并彻底重启VSCode，验证方式为终端执行which node（macOS/Linux）或where node（Windows）及npm -v。
node命令在VSCode终端里执行失败，调试直接卡死
VSCode调试Node.js的前提是它能真正“看到”你的Node安装——不是系统终端能跑node -v就行，而是VSCode内置终端必须能识别node和npm。很多调试配置看似没问题，实际启动时弹出Error: spawn node ENOENT，根源就在这儿。
- Windows用户：重装Node.js时务必勾选
Add to PATH；若已安装，手动把C:\Program Files\nodejs\加进系统环境变量的PATH，然后彻底退出VSCode再重启 - macOS/Linux用户：检查
~/.zshrc或~/.bash_profile是否含export PATH="/opt/homebrew/bin:$PATH"（Homebrew）或export PATH="/usr/local/bin:$PATH"（手动安装），改完后运行source ~/.zshrc，再重启VSCode - 验证方式：在VSCode里按
Ctrl + `打开终端，立刻执行which node（macOS/Linux）或where node（Windows），再跑npm -v——两个都成功才算过关
launch.json里怎么配才能同时跑Node后端+Chrome前端
想让VSCode一边断点调试app.js，一边在Chrome里调试index.html里的JS，不能靠一个配置硬扛，得用compound组合多个调试器。单独配type: "node"或type: "chrome"都只能单线程工作。
- 先确保已安装官方
JavaScript Debugger（VSCode 1.50+已内置，无需额外扩展） - 在
.vscode/launch.json里定义两个独立配置："name": "Launch Server"（request: "launch"，program指向后端入口）和"name": "Launch Chrome"（request: "launch"，url填http://localhost:3000之类） - 新增
compounds字段，写成："compounds": [{"name": "Full Stack", "configurations": ["Launch Server", "Launch Chrome"]}] - 注意端口别冲突：后端监听
3000，Chrome就访问http://localhost:3000；如果后端用8080，url也得同步改
断点进了后端却连不上Chrome开发者工具
VSCode显示“Debugger attached”，但Chrome按F12后找不到node_modules里的源码、看不到console.log输出，甚至sourceMaps全灰掉——这不是Chrome问题，是调试会话没对齐。
- 后端启动命令必须带
--inspect：比如node --inspect=9229 app.js，否则Chrome DevTools无法建立WebSocket连接 -
launch.json中"type": "chrome"配置的webRoot必须精确匹配静态资源路径，例如"webRoot": "${workspaceFolder}/public"，不能写"${workspaceFolder}"导致路径解析错乱 - 如果项目用Webpack/Vite等构建工具，确保
devtool: "source-map"开启，且output.path和devServer.static.directory指向同一物理目录 - Chrome地址栏输入
chrome://flags/#unsafely-treat-insecure-origin-as-secure，把localhost加进白名单（仅开发环境），避免HTTPS强制跳转干扰调试
nodemon热更新时断点失效怎么办
用nodemon跑服务时，VSCode断点变空心圆、提示Breakpoint ignored because generated code not found，本质是调试器连上了旧进程，新fork的进程没被接管。
- 别用
request: "launch"直接调nodemon——它会启动子进程，VSCode抓不到 - 改用
request: "attach"模式："type": "node"，"port": 9229，再配合nodemon --inspect=9229 app.js启动 - 或者更稳妥：在
package.json里加脚本"debug": "nodemon --inspect-brk=9229 --exec ts-node ./src/index.ts"（TS项目），--inspect-brk让进程启动即暂停，确保VSCode有足够时间attach - 每次修改代码后，VSCode右下角状态栏会显示“Restarting debug session…”——这是正常现象，说明attach成功并重建了连接
nodemon没传--inspect、webRoot路径少个/public、VSCode没重启就改了环境变量——整个链路就断了。调试器不会报具体哪一环坏了，只会安静地不响应。 
