VSCode C++多文件调试失败主因是launch.json与tasks.json路径未对齐：preLaunchTask值须严格匹配tasks.json中label（区分大小写）；源文件应显式列出或用CMake；program路径须与构建输出完全一致；改配置后需手动验证构建成功。
VSCode里C++多文件项目调试失败，90%是因为 launch.json 和 tasks.json 的路径没对齐——不是配置不对，是它们根本没“说同一种语言”。
为什么“build”标签必须被launch.json显式引用
VSCode不会自动把构建任务和调试配置连起来，它只认 label 字段。如果你在 tasks.json 里写了 "label": "build"，那 launch.json 的 preLaunchTask 就得写成 "preLaunchTask": "build"，少一个字母或大小写不一致都会跳过构建直接报错“program not found”。
-
preLaunchTask值必须与tasks.json中某个label完全一致（区分大小写） - 如果用了
dependsOn多阶段构建（比如先编译 .o 再链接），preLaunchTask应指向最终生成可执行文件的那个label，而不是中间步骤 - 不设
preLaunchTask时，VSCode默认不执行任何构建——哪怕你刚改完代码，它也会去跑旧的二进制
多文件编译时，${file} 和 *.cpp 的本质区别
${file} 只扩展当前打开的单个文件，而 *.cpp 是 shell 层面的通配符展开，实际行为取决于你用的是哪种终端和 shell（Windows cmd、PowerShell、bash 都不同）。在 tasks.json 的 args 里混用，极易导致漏编或编译失败。
- 用
${file}：适合单文件快速验证，但多文件项目中会漏掉utils.cpp、main.cpp等未打开的源文件 - 用
"*.cpp"（带引号）：多数情况下会被 VSCode 当作字面量传给 g++，结果变成编译一个叫 “*.cpp” 的文件——报错no such file - 真正可靠的做法是显式列出所有源文件：
"main.cpp", "utils.cpp", "network.cpp"，或用 CMake 自动生成构建逻辑
launch.json 中 program 路径必须与 tasks.json 输出路径严格一致
哪怕只差一个斜杠、一个空格、一个大小写，VSCode 就找不到可执行文件。常见错误是 tasks.json 输出到 ./bin/app，而 launch.json 写成 "${workspaceFolder}/BIN/app" 或 "${workspaceFolder}\bin\app"（Windows 下反斜杠在 JSON 中需双写，但推荐统一用正斜杠）。
立即学习“C++免费学习笔记（深入）”；
- 输出路径建议统一用
${workspaceFolder}/build/${fileBasenameNoExtension}这类变量组合，避免硬编码 - 检查路径是否真实存在：在终端里手动运行构建任务后，
ls build/或dir build\确认文件已生成 - Windows 用户特别注意：MinGW 路径含空格（如
C:\Program Files\mingw64）会导致tasks.json执行失败，command字段应使用无空格路径
调试器启动前 cwd 和 program 的相对关系容易被忽略
cwd（current working directory）决定程序运行时的根目录，它影响 fopen("config.txt") 这类相对路径的查找位置；而 program 是绝对路径，和 cwd 无关。但很多人误以为 program 是相对于 cwd 的。
-
program必须是完整路径（用变量拼出），不能写成"./build/app" -
cwd通常设为"${workspaceFolder}"，这样程序读取资源文件时能按项目结构找 - 如果程序依赖动态库（如
libjson.so），确保LD_LIBRARY_PATH（Linux）或PATH（Windows）包含对应目录，仅靠cwd解决不了
最常被绕过的环节是：改完 tasks.json 后没验证构建是否真成功，就急着调 launch.json。建议每次调整后，在终端里手动运行一次构建任务，确认二进制文件落地位置和权限都正确——这才是协同生效的前提。
