在 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。常用配置项包括：

OC SSH Tunnel Node Recovery

诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。

下载

• 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 模式运行。