VSCode不支持单配置多程序启动，必须通过compounds字段并行触发多个已定义的configuration；每个configuration只能有一个request:"launch"入口，且被引用的name须大小写精确匹配、预先定义。
VSCode 本身不支持“多项目并发启动”这个概念——它没有内置的多进程调试调度器，所有并发行为都依赖你手动组合配置。真正的并发启动必须靠 launch.json 中的 compounds 字段驱动，且每个参与并发的调试任务必须已作为独立 configuration 显式定义。
为什么单个 configuration 写多个 program 会失败
VSCode 的每个 configuration 只允许一个 request: "launch" 入口（如 program 或 module）。试图在同一个对象里填两个 program、用 && 拼接命令，或混用不同 type（比如同时写 "type": "node" 和 "type": "python"），都会被 VSCode 直接拒绝加载或静默忽略第二项。
这不是限制，而是设计使然：调试器需要独占控制进程生命周期、端口绑定、断点注入和变量作用域。多个入口意味着无法确定哪个是主进程、谁该先启、谁负责清理资源。
-
request: "attach"类型必须指向一个已运行且暴露了调试端口的进程，不能“启动”它 - 硬编码路径如
"program": "./backend/dist/index.js"不具备跨项目可移植性，建议用${workspaceFolder}或${fileDirname} - 若某个配置缺少
name字段，它将无法被compounds引用——名字大小写必须完全一致
compounds 是唯一可靠方式
compounds 是 launch.json 的顶层字段，它不启动新进程，而是并行触发多个已定义的 configuration。关键在于引用准确、顺序合理、就绪逻辑清晰。
- 所有被
compounds引用的name必须已在configurations数组中正确定义，拼写大小写敏感 - 默认是并行启动（VSCode 不等待 A 完成再启 B），但
request: "attach"会自动重试连接，直到目标端口响应 - 如果前端依赖后端 API 就绪，建议后端用
preLaunchTask启动服务，前端用type: "chrome"，并在compounds中把后端配置放前面（仅影响下拉菜单顺序，不影响实际并发）
示例 compounds 片段：
"compounds": [
{
"name": "Full Stack Dev",
"configurations": ["Backend: Spring Boot", "Frontend: React"]
}
]
Java 多模块项目要额外指定 projectName
对于 Maven 多模块项目，仅靠 mainClass 不够——调试器必须知道从哪个子模块加载 classpath。否则会报 ClassNotFoundException 或 NoClassDefFoundError，因为类路径只包含当前工作区根目录的 target/classes，而没包含依赖的其他子模块。
- 必须在对应
configuration中显式设置"projectName": "web-app"（值为子模块的 artifactId） - 确保工作区打开的是聚合工程根目录（即含父
pom.xml的文件夹），否则语言服务器无法构建完整依赖树 - 若使用 Spring Boot，推荐加
"console": "integratedTerminal"，避免调试控制台卡死或日志不输出
Node/Python 混合项目要注意 type 隔离
多根工作区里同时有 Node 和 Python 项目时，F5 默认会尝试匹配当前编辑文件的类型。但如果你在 app.py 里按 F5，却弹出“找不到 Python 解释器”，说明 VSCode 错拿了别的调试配置——常见于 type 名称冲突或未限定作用域。
- 每个
configuration必须显式指定"type"，且名称不重叠（如"type": "node"和"type": "python"） - Python 项目务必在
.vscode/settings.json中设"python.defaultInterpreterPath"，否则compounds启动时可能用错解释器 - Node 项目若依赖 nvm，请在
launch.json中用"runtimeExecutable": "${env:NVM_BIN}/node"，而非硬编码路径
最易被忽略的一点：VSCode 不会自动刷新已加载的调试配置。改完 launch.json 后，必须重启调试面板（关闭再打开 Run and Debug 视图），否则旧缓存仍生效。
