gcc必须能在命令行直接调用，否则Sublime构建无效；需将MinGW-w64的bin路径加入PATH并重启Sublime，再通过gcc --version验证成功后，方可配置C.sublime-build文件。
gcc 必须能在命令行直接调用，否则 Sublime 的任何配置都无效——这是唯一前置条件，不是可选项。
确认 MinGW-w64 已正确安装并进 PATH
别碰老版 MinGW，直接去 mingw-w64.org 下 Windows x86_64 版（选 posix 线程、seh 异常）。解压到纯英文无空格路径，例如 C:mingw64。
把 C:mingw64in 加进系统环境变量 PATH（改完必须彻底关闭并重启 Sublime Text，包括右下角托盘进程）。
新开一个 CMD 或 PowerShell，运行：
gcc --version
输出类似 gcc (x86_64-posix-seh-rev0, Built by MinGW-W64 project) 13.2.0 才算成功。如果报“不是内部或外部命令”，Sublime 调不动它，别往下试。
立即学习“C语言免费学习笔记（深入）”；
常见坑：
- 路径含中文或空格（如
C:Users张三Documents）→gcc静默失败，错误只显示fatal error: no input files，不提示原因 - 加了 PATH 但没重启 Sublime → 它读不到新环境变量
- 误把
gcc.exe复制到 Sublime 安装目录 → 完全无效
写一个真正能用的 C.sublime-build 文件
菜单 → Tools → Build System → New Build System…，粘贴以下内容（Windows）：
{
"cmd": ["gcc", "-std=gnu11", "-Wall", "-g", "${file}", "-o", "${file_path}/${file_base_name}.exe"],
"file_regex": "^(..[^:]*):([0-9]+):([0-9]+):?\s+(.*)$",
"working_dir": "${file_path}",
"selector": "source.c",
"shell": true
}
保存为 C.sublime-build（自动存到 Packages/User/ 目录）。
关键点：
-
"shell": true是 Windows 必选项，否则gcc可能因 CMD 环境差异找不到路径或解析错参数 - 用
-std=gnu11，不是-std=c11：MinGW 默认依赖 GNU 扩展头文件，否则uint32_t等类型会报unknown type name - 输出加
.exe后缀，否则 Windows 下双击或命令行执行时找不到文件 -
file_regex中的转义要写对（\s+），否则双击错误行无法跳转
为什么 Ctrl+B 没反应，或只显示 [Finished]
[Finished] 不代表成功，只代表命令执行完了——哪怕 gcc 编译出错也显示这个，容易误判。
常见现象和对策：
- Build 菜单灰掉 → 当前文件没设语言语法（右下角点
C，选C；或按Ctrl+Shift+P输入Set Syntax: C） - 编译通过但运行一闪而过 → Sublime 构建面板不支持交互式输入，
scanf或getchar()会被跳过。临时加getchar();在main结尾等回车 - Run 变体没输出 → 不要用
variants里的Run做交互程序，它本质是后台命令，无法响应键盘 - 想看完整输出又不想开终端 → 改用
shell_cmd+cmd /c包裹，但要注意引号嵌套和反斜杠转义
多文件项目或需要链接库怎么办
单文件 .sublime-build 无法处理依赖关系，硬塞 gcc a.c b.c -o main.exe 很快会失控。
真实项目该怎么做：
- 有数学函数（
sqrt、pow）？编译命令末尾加-lm - 用了标准库扩展头（如
<bits/stdc++.h>）？C++ 构建里加-static-libgcc -static-libstdc++，避免运行时缺 DLL - 超过两个源文件？别靠
.sublime-build硬凑，该上Makefile就上，Sublime 可以配"cmd": ["make"]直接调用 - 调试需求强？确保加了
-g，且禁用-O2或-O3，否则调试信息不可靠
最易被忽略的一点：Sublime 的构建系统永远只工作在当前文件所在目录，不会自动 cd 到项目根目录。路径变量如 ${file_path} 是相对的，跨目录引用必须手动拼全，不能假设“它懂上下文”。
