GDB 必须预先安装并加入 PATH，否则 Sublime 的任何调试配置均静默失效；需在构建系统中添加含 -g 参数和独立终端启动 GDB 的 variants 变体，并注意输出缓冲与 fork 行为。

确认 GDB 已就位，否则所有配置都白搭

Sublime Text 本身不带调试器，它只是“叫”gdb来干活。所以第一步不是打开 Sublime，而是打开终端（Windows 是 cmd/PowerShell，macOS/Linux 是 Terminal），执行：

gdb --version

如果报错 command not found 或 'gdb' is not recognized，说明 GDB 根本没装或没进 PATH。此时任何 .sublime-build 都会静默失败——你点 Ctrl+B 没反应，点 Debug 变体也没回音，连错误提示都不给。

• Windows：装 MinGW-w64（别用老版 MinGW），勾选 gdb 组件，安装完把 mingw64\bin 加进系统环境变量 PATH
• macOS：运行 xcode-select --install，再装命令行工具；或用 brew install gdb（注意 Apple 签名限制，需手动 codesign）
• Linux：Ubuntu/Debian 执行 sudo apt install gdb，其他发行版对应 dnf/pacman

构建系统里加个 GDB_C 变体，别只写编译命令

很多教程只配了 "cmd": ["gcc", "${file}", "-o", "..."]，这只能编译，不能调试。真正能调起 GDB 的，是 variants 里的一个独立变体，名字随便取（比如 "name": "GDB_C"），但必须满足两个硬条件：

• 编译时加 -g 参数（生成调试信息），缺了它 GDB 进去就是“盲人摸象”
• 用 start（Windows）或 gnome-terminal/open -a Terminal（Linux/macOS）新开终端跑 gdb，否则 Sublime 底部面板无法交互输入命令

Windows 下推荐的 C.sublime-build 片段（保存为 Packages/User/C.sublime-build）：

立即学习“C语言免费学习笔记（深入）”；

{
  "cmd": ["gcc", "${file}", "-o", "${file_path}/${file_base_name}"],
  "selector": "source.c",
  "working_dir": "${file_path}",
  "variants": [
    {
      "name": "GDB_C",
      "cmd": ["cmd", "/c", "gcc", "-g", "${file}", "-o", "${file_path}/${file_base_name}", "&&", "start", "cmd", "/k", "gdb", "${file_path}/${file_base_name}"]
    }
  ]
}

注意：/k 是关键——它让 cmd 窗口执行完 gdb 后不关闭，你才能敲 run、break main 等命令。

用 SublimeGDB 插件？先看清它的真实能力边界

很多人搜“Sublime 调试 C”，第一反应是装 SublimeGDB 插件。它确实能点断点、F5 启动、F10 单步，但有三个现实约束：

• 它不接管终端 I/O：如果你的程序用了 scanf 或 getchar()，输入会卡住，因为插件默认没有连接 stdin/stdout 到可交互窗口
• 它依赖 --interpreter=mi，而某些旧版 GDB（如 MinGW 自带的 8.x 以下）可能不完全兼容，导致启动失败或断点不命中
• 它对中文路径/文件名极敏感，一旦 ${file_path} 含中文，大概率报 No such file or directory

所以建议：新手先用上面纯构建系统 + 手动 GDB 的方式跑通流程；确认 gdb 能正常读源码、设断点、看变量后，再考虑是否上插件。真要用，务必在插件设置里显式指定：

{
  "working_dir": "${file_path}",
  "cmd": "gdb --interpreter=mi ${file_path}/${file_base_name}",
  "external_console": true
}

external_console: true 是 Windows 必选项，否则输入被吃掉。

调试时看不到输出？八成是忘了 fflush(stdout) 或没配 set follow-fork-mode child

你在 GDB 里 run 之后，程序闪退、没打印、断点不触发？常见原因不是配置错，而是 C 程序本身的缓冲行为：

• 标准输出默认行缓冲，遇到 \n 才刷；如果最后没换行（比如 printf("done")），gdb run 结束时缓冲区内容直接丢弃

• 解决：在 printf 后加 fflush(stdout)，或开头加 setvbuf(stdout, NULL, _IONBF, 0) 关闭缓冲
• 若程序用了 fork()（比如多进程调试），GDB 默认只跟 parent，子进程一跑就脱离控制；这时要在 GDB 启动后立刻输：set follow-fork-mode child

这些不是 Sublime 的锅，但它们会让“明明配好了却调不了”成为最常卡住新人的环节。

真正难的从来不是写几行 JSON，而是让 gcc、gdb、Sublime、你的 C 代码四者在内存模型、I/O 行为和路径编码上达成共识。少一个环节对齐，调试就变成猜谜。