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 行为和路径编码上达成共识。少一个环节对齐，调试就变成猜谜。
