VSCode调试C/C++需手动配齐gdb工具链、C/C++扩展及tasks.json、launch.json、c_cpp_properties.json三文件；缺一不可，否则F5报错。
VSCode 本身不带 GDB，必须手动配齐工具链、扩展和三个关键 JSON 文件，缺一不可；否则点 F5 只会报 Cannot find gdb 或 Failed to launch: program does not exist。
确认系统已安装可用的 gdb 并能被 VSCode 找到
VSCode 不会自己装 gdb，它只调用你系统 PATH 里的可执行文件。运行 gdb --version 必须有输出，且路径不能是 alias 或 shell 函数。
- Linux：通常
/usr/bin/gdb就是真身，检查用which gdb和ls -l $(which gdb) - macOS：Homebrew 安装的 gdb（如
/opt/homebrew/bin/gdb）需额外签名，否则启动即失败；更推荐用lldb配MIMode: "lldb" - Windows：用 MSYS2 或 WinLibs 提供的
gdb.exe，路径别含中文或空格，例如C:/msys64/mingw64/bin/gdb.exe - 如果
gdb命令可用但 VSCode 找不到，就在launch.json里显式写死"miDebuggerPath": "/usr/bin/gdb"
必须创建 .vscode/tasks.json 来生成带调试信息的可执行文件
没有 tasks.json，VSCode 就不知道怎么编译——哪怕你手动用 g++ 编好了，launch.json 中的 "program" 字段也大概率指向错误路径或缺失调试符号。
-
tasks.json的"args"必须含-g，否则断点无效、变量无法查看 - 推荐用
"${file}"作为输入源，"${fileDirname}/a.out"为输出，避免硬编码路径 - 若用 CMake，就不用手写
tasks.json，但必须先运行CMake: Configure和CMake: Build，确保 build 目录下真有带-g的二进制 - 验证是否成功：在终端里跑
file ./a.out应含with debug_info；readelf -S ./a.out | grep debug应有多个.debug_*段
launch.json 的核心字段不能只靠自动生成
VSCode 点“创建 launch.json”生成的模板往往漏掉关键项，尤其在 attach、root 权限或跨平台场景下，直接 F5 必然失败。
-
"request": "launch"是默认模式；要 attach 到已有进程，必须改为"request": "attach"，并补全"processId"或用"pid"配合 preLaunchTask -
"program"必须是绝对路径或基于工作区的可靠相对路径（如"${fileDirname}/a.out"），不能是"./a.out"—— Windows 下反斜杠和当前目录解析不稳定 - Linux 下调试 root 进程时，不要在
"miDebuggerPath"里写"sudo gdb"，会破坏 DAP 协议；正确做法是用sudo code --user-data-dir="/tmp/vscode-root" --no-sandbox启动整个 VSCode - 加
"externalConsole": true，特别是跑 AddressSanitizer 时，否则 ASan 报错会被集成终端吞掉或刷屏
调试时断点不命中？先查这三件事
90% 的“断点灰了”或“命中断点但变量为空”问题，跟 launch.json 写得漂不漂亮无关，而是底层环境没对齐。
- 确认你 attach 的进程，其
/proc/<pid>/exe</pid>软链接指向的二进制，和launch.json里"program"值完全一致（用ls -l /proc/<pid>/exe</pid>对比） - 检查该二进制是否被 strip 过：
file ./a.out输出里不能有stripped字样；否则gdb ./a.out里info functions都看不到符号 - 如果你在 WSL 或远程 SSH 环境调试，
launch.json里所有路径都得是目标系统的路径格式（Linux 风格），而非 Windows 主机上的路径
最常被跳过的细节是：改完 tasks.json 后没重新运行构建任务，就急着按 F5；或者以为 launch.json 配对了就能 debug，却忘了 gdb 根本没权限 attach 到那个进程——这时候看一眼 dmesg | tail，十有八九是 ptrace: Operation not permitted。
