VS Code 调试用 Compound 同时启动多个调试目标的实现方法

前后端联调时，如果每次都分别点击两个调试配置，容易漏启动一个目标。VS Code 的 Compound 可以把已有的两个或多个 launch 配置按名称组合起来，用一次 F5 并行启动。本文只处理 launch.json 的组合关系，不涉及具体语言调试器的安装。

官方地址：https://code.visualstudio.com/docs/debugtest/debugging

准备工作：先让两个调试目标各自可启动

打开项目文件夹，在左侧活动栏选择“运行和调试”。如果还没有配置，点击“创建 launch.json 文件”，选择项目对应的调试环境。VS Code 会在项目根目录创建 .vscode/launch.json。已有配置时，先在配置下拉框中分别选择两个目标并单独按 F5，确认它们不是因为路径、入口文件或扩展缺失而失败。

每个 launch 配置至少要有 type、request 和 name。Compound 后续只认识 name，因此建议使用稳定且一眼能区分的名称，例如 Server 和 Client。

在 launch.json 中组合并行调试目标

在资源管理器打开 .vscode/launch.json，保留原来的 configurations 数组，然后在同一个 JSON 根对象中增加 compounds。下面是一个可按项目入口替换的最小结构；JSON 不支持注释，所以字段含义放在代码块之后说明。

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Server",
      "program": "${workspaceFolder}/server.js"
    },
    {
      "type": "node",
      "request": "launch",
      "name": "Client",
      "program": "${workspaceFolder}/client.js"
    }
  ],
  "compounds": [
    {
      "name": "Server + Client",
      "configurations": ["Server", "Client"],
      "stopAll": true
    }
  ]
}

configurations 里的两个字符串必须与上方配置的 name 完全一致；program 只是 Node 示例，换成 Python、Go 或其他调试器时，应使用对应扩展支持的字段。stopAll: true 表示手动停止其中一个会话时联动停止 Compound 中的其他会话；如果你希望单独保留另一个目标运行，可以改为 false 或省略。

保存文件后回到“运行和调试”视图，打开配置下拉框。除了 Server、Client 这样的单目标项，还应出现 Server + Client。若没有出现，先检查 JSON 括号、逗号和名称拼写；不要把 Compound 名称写进 configurations 数组内部。

选择 Compound 并确认两个会话都已启动

在“运行和调试”视图顶部的配置下拉框选择“Server + Client”，点击绿色开始按钮或按 F5。启动过程中先看调试工具栏和 CALL STACK：两个单独会话应作为顶层元素出现，而不是只有一个名称。VS Code 的多目标调试模式下，工具栏动作作用于当前活动会话，可以用下拉框或点击 CALL STACK 的另一项切换。

再打开 DEBUG CONSOLE，分别观察两个目标的启动输出。这里要核对的是“两个会话都存在且各自有输出”，不是要求所有项目都必须打印固定文本。若只看到一个会话，回到单目标配置检查；若两个会话都在但某一项立即退出，优先排查该目标自身的入口和参数。

常见问题：配置出现但启动结果不对

Compound 为什么不在下拉框中？

最常见原因是 launch.json 语法错误、没有打开项目文件夹，或 compounds 没有放在根对象层级。先让编辑器的红色波浪线消失，再重新打开运行和调试视图。

为什么配置名称改了以后 Compound 失效？

Compound 使用字符串匹配 name。重命名单目标后，必须同步修改 compounds.configurations 中的引用；仅修改 Compound 自己的显示名称不够。

stopAll 应该设为 true 还是 false？

联调时通常选 true，停止一个目标就结束整组，避免留下孤立进程。需要保留服务端继续运行、只重启客户端时，再选择 false，并确认项目能承受两个会话独立生命周期。

最终确认清单

这样配置后，多个目标仍然保持各自独立的调试参数，但入口被收敛为一个可复用的 Compound。以后新增目标时，只需先新增并验证单目标配置，再把它的准确 name 加入对应 Compound。