在 vscode 中调试 node.js 后端需正确配置 launch.json：确保 node.js ≥14、有 package.json 和可执行入口文件；通过命令生成 launch.json，设置 type、request、program 等字段；添加断点后按 f5 启动，支持变量查看与步进调试；web 框架调试可改端口、配合 nodemon 实现热重载。
在 VSCode 中调试 Node.js 后端应用非常直观，关键是正确配置 launch.json 并启动调试会话。不需要额外安装插件（VSCode 自带 Node.js 调试支持），但需确保系统已安装 Node.js 且版本 ≥ 14。
确认 Node.js 环境和项目结构
运行 node -v 和 npm -v 验证环境可用；确保项目根目录下有 package.json，入口文件（如 index.js 或 app.js）能被正常执行（node index.js 可启动服务）。若使用 TypeScript，需先配置 ts-node 或编译输出 dist 目录。
生成并配置 launch.json
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 “Debug: Open launch.json”，选择 “Node.js” 环境，VSCode 会自动生成 .vscode/launch.json。常用配置项包括：
-
type：固定为
node -
request：设为
launch（本地启动）或attach（连接已运行进程） -
program：指定入口文件路径，如
${workspaceFolder}/index.js -
env：可添加环境变量，例如
"NODE_ENV": "development" -
console：建议设为
integratedTerminal，便于查看日志和交互
设置断点并启动调试
在代码行号左侧灰色区域单击，出现红点即为断点；支持在 if、循环、函数调用等任意有效语句行设置。按 F5 启动调试，VSCode 会自动运行 Node.js 进程，并在断点处暂停。此时可使用调试面板查看变量值、调用栈、监视表达式，或按 F10（逐过程）、F11（逐语句）继续执行。
调试 Express/Koa 等 Web 框架的技巧
后端常监听端口（如 app.listen(3000)），调试时需注意：
- 避免端口冲突：可在
launch.json的env中临时改端口，如"PORT": "3001" - 热重载支持：VSCode 原生不支持自动重启，可配合
nodemon—— 将program改为${workspaceFolder}/node_modules/.bin/nodemon，并添加"args": ["--exec", "node", "--inspect-brk", "${workspaceFolder}/index.js"] - 检查请求：搭配 Postman 或 curl 发起请求，触发断点；也可在路由处理函数开头直接加断点
基本上就这些。调试体验流畅的关键是配置准确、断点合理、环境干净。遇到“无法命中断点”，优先检查文件路径是否正确、是否在源码（而非编译后）上设点、以及 Node.js 是否以 --inspect 模式运行。
