VSCode怎么配置复合调试compounds实现多服务联调-VSCode-PHP中文网

compounds 是唯一合法的多服务启动方式；vscode 原生不支持单 configuration 启动多进程，仅 compounds 可并行启动多个已命名、端口不冲突、console 为 integratedterminal 的调试配置。

vscode怎么配置复合调试compounds实现多服务联调

VSCode 原生不支持在一个 configuration 里启动多个进程。你在 configurations 数组里写两个 "type": "node" 配置，VSCode 只会执行第一个——这不是 bug，是设计如此。真正能同时拉起多个服务的，只有 compounds 块。

它本质是一个“调度层”：你先定义好若干个独立、可运行的调试配置（每个 name 必须唯一），再用 compounds 把它们的名字列出来，VSCode 才会并行启动全部。

最常见的“启动了但断点不命中”，其实是第二个 node --inspect 进程因为端口被占而静默失败。VSCode 默认复用 9229，但 compounds 下所有服务必须显式分配不同端口。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

每个 configuration 里必须加 "port": 9230、"port": 9231 等，不能省略
启动后务必检查终端输出有没有 Debugger listening on ws://127.0.0.1:9230/ —— 没这行，说明调试器根本没起来
Windows 用户记得在任务管理器里杀干净残留 node.exe；macOS/Linux 推荐 pkill -f "node --inspect"，比只点 VSCode 的停止按钮更彻底

如果你发现第二个服务启动后终端没反应、调试器连不上，大概率是漏了这一项。VSCode 在 compounds 模式下，对非主控终端的附加行为很敏感。

所有参与 compounds 的配置都必须设 "console": "integratedTerminal"
设成 "externalTerminal" 或不写，默认值，会导致后续服务无法正确 attach，卡在“connecting…”
这个设置和 "request": "launch" 必须共存："request": "attach" 仅适用于你已手动跑起 node --inspect 的场景，compounds 下基本不用

TypeScript 编译后的 JS 文件路径和源码路径不一致，是断点失效最隐蔽的原因。VSCode 调试器 attach 的是 Node.js 实际运行的文件，不是你编辑器里打开的 .ts。

program 必须指向编译产物，比如 "${workspaceFolder}/dist/api/index.js"，而不是 src/ 下的 ts 文件
如果坚持用 ts 源码路径，就得配 "outFiles": ["${workspaceFolder}/dist/**/*.js"]，让调试器知道去哪里映射
preLaunchTask 如果没成功执行（比如 tsc 编译失败），program 指向的文件就不存在，VSCode 不报错，但断点永远不触发

多服务调试真正的复杂点不在配置语法，而在于每个服务的生命周期是否真正进入调试态——端口、终端类型、路径、构建状态，四个条件缺一不可。少一个，表面看“启动成功”，实际只是进程在黑盒里空转。