VSCode调试C程序失败90%因gdb未装好、路径错误或tasks.json未加-g参数；需验证gdb版本≥12.1、program路径与编译输出一致、项目路径纯英文、c_cpp_properties.json配置正确。
VSCode 本身不带调试能力，launch.json 配不起来，90% 是因为 gdb 没装好、路径没写对，或者 preLaunchTask 指向的编译任务根本没生成带调试信息的可执行文件。
确认 gdb 是否可用且版本兼容
VSCode 调试 C 程序依赖外部 gdb，不是插件自带的。Windows 上用 MinGW-w64 的 gdb.exe，Linux/WSL 用系统 gdb，macOS 用 lldb（需额外配置）。先在终端里验证：
- 运行
gdb --version，必须能输出版本号（如14.2），不能报“不是内部或外部命令” - 若用 MinGW-w64，确保下载的是带
gdb的完整包（winlibs 或 MSYS2 安装时勾选gdb） - 旧版
gdb（如 8.x）在 VSCode 1.90+ 中可能无法读取 DWARF 调试信息，建议用gdb 12.1+或更高
tasks.json 必须生成带 -g 的可执行文件
launch.json 里的 program 字段指向的文件，必须是编译时加了 -g 参数的产物。否则断点全灰、变量看不到。常见错误是 tasks.json 里漏了 -g，或用了 code-runner 插件自动编译（它默认不带调试信息）。
- 检查
tasks.json的args数组：必须包含"-g"，且位置在源文件之后、"-o"之前 - 示例正确写法：
"args": ["-g", "${file}", "-o", "${fileDirname}/${fileBasenameNoExtension}.exe"] - 编译后手动在终端运行
file your_program.exe（Linux/macOS）或objdump -h your_program.exe | grep debug（Windows），确认输出里有.debug_*段
launch.json 的 cwd 和 program 路径必须匹配实际生成位置
VSCode 调试器启动时，工作目录（cwd）和可执行文件路径（program）不一致，会导致找不到文件、scanf 卡住、相对路径读文件失败。
立即学习“C语言免费学习笔记（深入）”；
-
program值必须和tasks.json里"-o"指定的输出路径完全一致（包括扩展名，Windows 是.exe） -
cwd建议设为"${fileDirname}"，这样程序运行时当前目录就是源文件所在目录，读写本地文件不会出错 - 避免用绝对路径写死
program，不同机器路径不同；也不要写成"./a.out"这类相对路径，VSCode 不保证工作目录就是项目根目录
中文路径或空格会导致 gdb 启动失败
MinGW-w64 的 gdb 对含中文、空格、括号的路径支持极差，哪怕只是项目文件夹名带中文，launch.json 一保存就报 Unable to start debugging。
- 把项目放在纯英文路径下，例如
C:\projects\hello_c，不要用桌面、我的文档、Test Project (2026) - 检查
tasks.json和launch.json里所有${...}变量展开后是否含中文或空格（可用echo ${fileDirname}在终端验证） - 如果必须用中文路径，暂时改用 WSL +
gdb，它对路径容错性更好
最常被忽略的一点：c_cpp_properties.json 里 intelliSenseMode 和 compilerPath 虽然不影响调试器启动，但一旦配错，会导致断点命中后变量值显示为 <optimized out>——不是代码问题，是调试信息被编译器优化掉了，而 VSCode 没法提醒你这点。
