配置VS Code调试Node.js需创建launch.json文件，设置program指向入口文件，console输出到终端，env配置环境变量，restart启用自动重启；若使用TypeScript，需在tsconfig.json中开启sourceMap并指向编译后文件；可通过--inspect-brk启动nodemon并附加调试器连接9229端口；利用断点、调试控制台、变量悬停和调用栈等功能提升排查效率，合理配置可显著减少依赖console.log的调试时间。
在 VS Code 中调试 Node.js 后端可以非常高效，只要配置得当。关键在于利用内置的调试器结合合理的配置和工具，实现断点调试、实时日志查看和快速迭代。
配置 launch.json 文件
VS Code 使用 .vscode/launch.json 来定义调试配置。为 Node.js 项目创建一个合适的启动配置是第一步。
在项目根目录下创建 .vscode/launch.json，内容如下：
{ "version": "0.2.0", "configurations": [ { "type": "node", "request": "launch", "name": "启动服务器", "program": "${workspaceFolder}/app.js", "outFiles": ["${workspaceFolder}/**/*.js"], "console": "integratedTerminal", "env": { "NODE_ENV": "development" }, "restart": true } ] }说明：
- program 指向你的入口文件（如 app.js 或 server.js）
- console: integratedTerminal 让输出显示在终端中，便于查看日志
- env 设置环境变量，有助于条件判断
- restart: true 在重启后自动附加调试器
使用源码映射支持 TypeScript
如果你使用 TypeScript，确保编译时生成 source map，并在 launch.json 中启用。
在 tsconfig.json 中开启：
{ "compilerOptions": { "sourceMap": true, "outDir": "./dist", "rootDir": "./src" } }然后修改 launch.json 的 program 指向编译后的文件，例如：
"program": "${workspaceFolder}/dist/app.js", "outFiles": ["${workspaceFolder}/dist/**/*.js"]这样可以在 src 目录下的 .ts 文件中直接设断点，调试时能正确映射。
附加到正在运行的进程
有时你希望连接到已启动的服务，比如用 nodemon 运行的应用。
先以调试模式启动应用：
nodemon --inspect-brk app.js然后在 launch.json 添加一个附加配置：
{ "name": "附加到进程", "type": "node", "request": "attach", "port": 9229, "restart": true }启动该配置后，VS Code 就会连接到运行中的服务，适合热重载场景。
善用调试功能提升效率
VS Code 提供了丰富的调试功能，合理使用能显著提升排查问题的速度。
- 在代码行号左侧点击设置断点，执行到该行会暂停
- 使用“调试控制台”查看变量值、执行表达式
- 鼠标悬停在变量上可快速查看当前值
- 调用栈面板帮助理解程序执行路径
- 条件断点：右键断点可设置触发条件，避免频繁中断
配合 console.log 使用时，建议临时添加关键日志，再通过断点验证逻辑是否符合预期。
基本上就这些。一套好用的调试配置能让开发 Node.js 后端更顺畅，减少靠打印排查问题的时间。不复杂但容易忽略细节，比如路径、source map 和启动方式。配一次，长期受益。
