Node.js开发者用好VSCode调试的关键在于理解流程、正确配置launch.json、灵活使用断点及调试控制台；VSCode内置调试器支持单文件、项目、子进程与远程调试，无需额外插件。
Node.js开发者用好VSCode调试功能，关键不在装插件，而在理解调试流程、配置好launch.json、善用断点和调试控制台。VSCode自带的Node.js调试器（基于Chrome DevTools Protocol）足够强大，无需额外工具链就能完成单文件、项目、子进程甚至远程调试。
配置正确的 launch.json 是调试的前提
VSCode不会自动识别你的入口文件，必须手动配置调试启动项。在项目根目录创建.vscode/launch.json，常用配置如下：
- 启动当前打开的JS文件：选择“Node.js: Current File”，适合快速验证脚本逻辑
-
启动特定入口文件：设置
"program": "${workspaceFolder}/src/index.js"，并加上"skipFiles": ["<node_internals>/**"]</node_internals>避免跳进Node源码 -
带参数或环境变量启动：用
"args"传命令行参数，"env"设环境变量（如"NODE_ENV": "development"） -
自动重启调试：配合
nodemon，把"runtimeExecutable"设为"nodemon"，再加"restart": true
灵活使用断点，不只是点击左侧边栏
断点是调试的核心交互点，但不止“红点”一种用法：
-
条件断点：右键断点 → “Edit Breakpoint” → 输入表达式（如
i === 10），只在满足条件时暂停 -
日志断点：不暂停执行，只输出内容（如
当前用户: ${user.name}），适合高频循环中观察状态 -
函数断点：在“BREAKPOINTS”面板点“+”号，输入函数名（如
app.listen），对动态绑定或第三方库内部调用很实用 - 未捕获异常断点：在“BREAKPOINTS”面板勾选“Uncaught Exceptions”，调试时立刻停在报错源头
调试控制台比终端更贴近运行时上下文
调试过程中打开“DEBUG CONSOLE”（不是集成终端），它共享当前断点的执行上下文：
- 可以直接输入
user、req.query等变量名查看值，支持展开对象、调用方法 - 可执行赋值语句临时修改状态（如
id = 123），用于模拟特定分支逻辑 - 输入
debugger会立即触发断点（即使代码里没写），适合临时插入调试点 - 按
Ctrl+Space可触发变量名自动补全，依赖当前作用域
调试多进程和TS项目只需微调配置
实际项目常涉及子进程（如child_process.fork）或TypeScript源码，调试仍可原生支持：
-
调试子进程：在主进程启动配置中加
"processId": true，并在子进程中用execArgv: ['--inspect-brk']启动，VSCode会自动附加 -
调试TS项目：确保已生成
.js和.js.map文件；在launch.json中设置"outFiles": ["${workspaceFolder}/dist/**/*.js"]，并启用"sourceMaps": true -
Attach模式调试已运行进程：启动Node时加
--inspect=9229，再用attach配置连接，适合调试Docker容器内或PM2管理的进程
基本上就这些。VSCode的Node.js调试能力足够覆盖日常开发95%的场景，难点往往在于配置细节没对上，而不是功能不够。配好一次launch.json，后面所有调试都顺滑得多。
