VS Code通过配置launch.json中的compounds实现多目标调试，将多个微服务的独立调试配置组合启动，统一管理前端、网关和后端服务，提升全链路调试效率。
VS Code 支持通过 multi-target debugging（多目标调试） 同时调试多个微服务进程，比如一个前端、一个 API 网关、若干后端服务。关键在于合理配置 launch.json 中的 configurations，并利用 compounds 将它们组合启动。
配置多个独立的调试配置
每个微服务对应一个独立的 configuration，需明确指定：
-
name：唯一标识名（如
"backend-auth"、"frontend-react"） -
type：调试器类型（
"node"、"pwa-node"、"go"、"python"等） -
request：通常为
"launch"或"attach"（本地开发常用"launch"） -
program / file / args：启动命令和参数（例如
"${workspaceFolder}/auth/src/index.js"） - port：Node.js 等需调试端口，确保不冲突（如 9229、9230、9231）
-
env：可设环境变量（如
"NODE_ENV": "development"）
用 compounds 组合启动多个服务
在 launch.json 的 compounds 数组中定义一个组合项，引用上面配置好的多个 name：
"compounds": [
{
"name": "Debug Microservices",
"configurations": ["backend-auth", "backend-user", "api-gateway"]
}
]
保存后，调试面板顶部下拉菜单里就会出现 Debug Microservices，点击 ▶ 即可一键启动全部服务，并自动附加调试器。
调试体验优化技巧
多服务调试时容易混乱，建议：
-
统一日志前缀：各服务输出日志时加上服务名（如
[auth]），便于终端区分 -
启用“Auto Attach”：对 Node.js 项目，在设置中开启
debug.node.autoAttach，避免手动 attach -
分离终端标签页：在
launch.json中加"console": "integratedTerminal"并配合"terminal": "new"（部分调试器支持），让每个服务独占终端 -
设置依赖启动顺序：若某服务必须等另一服务就绪才能启动，可用
preLaunchTask或脚本封装（如用concurrently启动 +wait-on检查健康端点）
常见问题注意
实际使用中容易踩坑的地方：
-
端口冲突：多个 Node.js 服务不能共用同一个
port（调试端口），需显式错开 -
路径错误：
program路径建议用${workspaceFolder}变量，避免硬编码 -
断点不命中：确认源码映射（source map）已生成且
outFiles或resolveSourceMapLocations配置正确 - 调试器不识别：确保已安装对应扩展（如 “Debugger for Chrome”、“Go”、“Python”）
基本上就这些。配置一次，后续点一下就能全链路调试，省去反复切换终端和手动 attach 的麻烦。
