VSCode调试Node.js需掌握launch.json配置与三种模式：基础launch、attach已运行进程、nodemon热重载。关键字段包括type、request、program、port等，配合断点与sourceMap可高效定位问题。
VSCode 调试 Node.js 应用不难，关键在于配置对、启动准、断点稳。只要搞懂 launch.json 的核心字段和常见场景的调试模式，90% 的问题都能在编辑器里直接定位。
一、基础调试：自动配置 + F5 启动
新建 Node.js 项目后，打开根目录，在命令面板（Ctrl+Shift+P / Cmd+Shift+P）中输入 Debug: Open launch.json，选择环境为 Node.js。VSCode 会自动生成一个默认配置，通常是：
- type: "node" —— 表示使用 Node 调试器
- request: "launch" —— 启动新进程调试（最常用）
- program: "${workspaceFolder}/index.js" —— 入口文件路径，按需修改
- console: "integratedTerminal" —— 输出显示在集成终端，方便看日志
保存后，设好断点（代码行号左侧单击），按 F5 就能跑起来。注意：确保已安装 Node.js 且 node -v 可执行。
二、调试已运行的 Node 进程（Attach 模式）
适合调试 Express/Koa 等长期运行的服务，或想复用 npm script 启动方式时。先让程序以调试模式运行：
- 命令行启动：
node --inspect-brk index.js（--inspect-brk会在第一行暂停） - 或用 npm script：
"debug": "node --inspect-brk index.js"，然后npm run debug
再在 launch.json 中添加一个 Attach 配置：
{
"type": "node",
"request": "attach",
"name": "Attach to Process",
"port": 9229,
"address": "localhost",
"restart": true
}
运行这个配置，VSCode 就会连接到正在监听 9229 端口的 Node 进程。端口号要和 --inspect 后指定的一致（默认 9229）。
三、用 Nodemon 自动重启 + 调试
开发时改完代码不想手动重启？把 Nodemon 和调试结合即可。先确保全局或本地装了 nodemon：npm install --save-dev nodemon。
在 launch.json 中写一个带 runtimeExecutable 的配置：
{
"type": "node",
"request": "launch",
"name": "Nodemon Debug",
"runtimeExecutable": "${workspaceFolder}/node_modules/.bin/nodemon",
"runtimeArgs": ["--inspect-brk", "${workspaceFolder}/index.js"],
"console": "integratedTerminal",
"restart": true,
"port": 9229
}
注意：runtimeArgs 里传 --inspect-brk 是为了让每次重启都停在第一行；VSCode 会自动等待端口就绪再连接。Windows 用户若提示找不到 nodemon，可改用 nodemon.cmd 或用 npx nodemon 替代 runtimeExecutable。
四、常见卡点与对策
调试失败？大概率是这几个地方出了问题：
-
断点灰了（未命中）：检查是否在 transpiled 代码（如 TypeScript/Babel）上打点——应在源码（.ts/.jsx）打，配合
sourceMaps: true和正确的outFiles路径 - “Cannot connect to runtime”：确认 Node 进程确实在监听调试端口；检查防火墙或杀毒软件是否拦截了 9229 端口
-
控制台无输出：看看
console字段是不是设成了internalConsole（旧版行为），建议统一用integratedTerminal - 调试器连上了但没反应：可能是 Node 版本太新（v20+），VSCode 旧版本支持不佳，升级到最新版 VSCode 即可
基本上就这些。配一次，后面所有项目复制粘贴改个 program 路径就能用。
