VSCode需正确配置compilerPath指向可执行编译器（如/usr/bin/gcc）、tasks.json中补全-o输出参数及必要编译选项、launch.json匹配调试器路径并设置sourceFileMap等，否则导致调试失败或断点不命中。
怎么让 VSCode 正确识别 gcc 或 clang 路径
VSCode 本身不自带编译器，c_cpp_properties.json 里填错 compilerPath 是调试失败最常见原因。它不是“选个路径就行”，而是必须指向可执行的编译器二进制文件（比如 /usr/bin/gcc 或 C:msys64ucrt64ingcc.exe），且该编译器得能响应 --version。
- Windows 用户容易把 MinGW 的路径配成
C:msys64mingw64这种目录，但正确路径是C:msys64mingw64ingcc.exe - macOS 上用 Homebrew 安装的
gcc实际是gcc-13这类带版本号的链接，直接填gcc会报 “command not found” —— 得填/opt/homebrew/bin/gcc-13或用which gcc-13确认 - Linux 下如果系统有多个 GCC 版本（如
gcc-11、gcc-12），compilerPath填哪个，就决定IntelliSense用哪个标准解析头文件，和后续编译器实际调用未必一致（这点常被忽略）
tasks.json 里 args 怎么写才不漏关键参数
很多人只写 ["-g", "${file}"]，结果生成的可执行文件没调试信息，或者链接失败。VSCode 的 tasks.json 是把命令行“翻译”成 JSON，空格、引号、顺序全得对上。
-
-o后面必须跟输出文件名，比如"-o", "${fileDirname}/${fileBasenameNoExtension}"；漏掉这步，gcc默认输出到a.out，但launch.json里却指定了别的文件名，调试直接报 “cannot find executable” - 如果源文件用了 C++17 特性，光写
-std=c++17不够，还得加-g（否则断点无效）、-O0（优化会打乱代码行映射） - Windows 下用 MinGW 编译时，
args里别写-static-libgcc -static-libstdc++除非真需要静态链接——否则容易触发undefined reference to `WinMain'错误（因为链接器误判为 GUI 程序）
launch.json 中 miDebuggerPath 和 setupCommands 怎么配合用
调试器路径配错，VSCode 就根本启不动 gdb 或 lldb；但即使路径对了，不关掉某些默认行为，也会卡在启动阶段或无法显示局部变量。
-
miDebuggerPath必须指向调试器本体：Linux/macOS 是gdb或lldb，Windows 是gdb.exe（MinGW 自带）或vsdbg（WSL 场景下不能混用） - Mac 上用
lldb时，setupCommands里得加{"description": "Enable pretty-printing for gdb", "text": "-enable-pretty-printing", "ignoreFailures": true}—— 否则std::vector这类容器只显示内存地址 - Linux 下如果程序用了
dlopen动态加载，launch.json里要加"stopAtEntry": false和"environment": [{"name": "LD_LIBRARY_PATH", "value": "${workspaceFolder}/lib"}]，不然调试器找不到运行时依赖
为什么改了配置还是断点不命中
断点不命中不是配置漏了，往往是编译、调试、源码三者“时间戳”或“路径映射”对不上。VSCode 调试器靠 DWARF 信息定位代码行，任何一环脱节都会失效。
立即学习“C++免费学习笔记（深入）”；
- 编辑完源码没重新编译就按 F5 ——
launch.json的program指向旧的二进制，DWARF 信息还是老的，断点自然落空 - Windows 上用 WSL2 开发时，
program路径写成\wsl$Ubuntuhomeuserproj.out会导致路径解析失败；必须用/home/user/proj/a.out并确保cwd也用 Linux 风格路径 - 多文件项目里，
tasks.json如果只编译当前文件（${file}），而其他.c文件有改动但没重编，链接后的程序行为和源码不一致，断点可能跳转到意外位置
最麻烦的是符号文件和源码不在同一台机器：比如在容器里编译，宿主机调试。这时候得用 sourceFileMap 显式告诉调试器 “/build/src” 对应 “${workspaceFolder}/src”。没人手动配这个，断点就永远灰着。
