必须先在系统中可用，sublime 才能调用它编译 c 文件；否则所有构建配置都无效。确认方法：终端执行 gcc --version 能输出版本号，windows 需将 mingw-w64 的 bin 目录加入 path 并重启 sublime，macos 需建软链，linux 用 apt 或 dnf 安装 build-essential。
gcc 必须先在系统中可用，Sublime 才能调用它编译 C 文件；否则所有构建配置都无效。别急着写 .sublime-build，先确认终端里能打出 gcc --version。
怎么确认 GCC 已正确安装并可被 Sublime 调用
Sublime 启动时会继承当前 shell 的环境变量（包括 PATH），所以它能不能找到 gcc，完全取决于你终端里能不能运行成功。
- 在终端（macOS/Linux）或命令提示符/PowerShell（Windows）中执行
gcc --version，必须返回类似gcc (MinGW-W64) 13.2.0或clang version 18.1.8的输出 - Windows 用户装 MinGW-w64 后，务必把
bin/目录（如C:mingw64in）加进系统PATH，然后**重启 Sublime**——用快捷方式双击打开的 Sublime 可能读不到新 PATH - macOS 用户若用 Homebrew 安装了
gcc-14，但gcc命令仍不可用，需手动建软链：sudo ln -s /opt/homebrew/bin/gcc-14 /usr/local/bin/gcc - Linux 用户检查
which gcc是否有输出；没装就先sudo apt install build-essential（Ubuntu/Debian）或sudo dnf groupinstall "Development Tools"（Fedora）
Windows 下 .sublime-build 必须设 "shell": true 且路径要带 .exe
MinGW-w64 的 gcc.exe 在 Windows 上不支持直接用 cmd 数组模式调用（尤其路径含空格时），必须启用 shell 层并显式写后缀。
- 不要用
"cmd": ["gcc", "${file}", "-o", "${file_base_name}"]—— 这在 Windows 上大概率报'gcc' is not recognized - 改用
"shell_cmd"并包裹cmd /c："shell_cmd": "cmd /c "gcc \"${file}\" -o \"${file_path}/${file_base_name}.exe\" -Wall -g"" -
${file_base_name}.exe是关键：Windows 可执行文件必须有.exe后缀，否则生成的文件无法运行 -
"shell": true对"cmd"数组也有效，但仅限 Windows；macOS/Linux 不需要，用了反而可能出错
为什么 Ctrl+B 编译成功但 Run 没输出，或一运行就退出
Sublime 的输出面板不是真正的终端，它不支持交互式输入（如 scanf、getchar()），也不保留进程上下文。所谓 “Run” 变体只是把命令塞进面板执行完就收工。
- 如果代码里有
scanf("%d", &x)，面板会卡住不动，或直接显示[Finished]却无响应——这不是 bug，是设计如此 - 想看真实输出或调试输入，必须手动开终端：
cd到源文件所在目录（即${file_path}），再运行./${file_base_name}（macOS/Linux）或${file_base_name}.exe（Windows） - 避免在
variants里写"shell_cmd": "... && ./a.out"这类依赖默认a.out的写法——gcc不加-o时才生成a.out，而你明确指定了输出名，就不能硬编码 - 数学函数（
sqrt、pow）必须加-lm链接选项，否则undefined reference to 'sqrt'错误不会在面板里完整显示，容易漏看
多文件项目或自定义头文件时，别硬套单文件构建系统
.sublime-build 是为单文件快速验证设计的，它没有依赖分析、增量编译或头文件路径自动推导能力。一旦项目结构变复杂，这套机制就会失效。
- 自定义头文件（如
inc/utils.h）必须显式加-I参数："cmd": ["gcc", "-I", "./inc", "${file}", "-o", "${file_path}/${file_base_name}"] - 多个
.c文件不能靠一个${file}变量解决——${file}只代表当前激活标签页的文件，其他源文件根本不会参与编译 - 真要处理多文件，要么手写
Makefile并配个"cmd": ["make"]构建系统，要么换用 VS Code + C/C++ 扩展或 CLion 这类原生支持项目管理的工具 - 第三方库（如
libcurl.a）链接顺序很重要：-L./lib -lcurl必须成对出现，且-L要在-l之前，否则链接器找不到库
gcc 实际执行时的路径、权限、链接顺序和标准库隐含依赖。每加一个 -I、-L 或 -l，都要验证它是否真的生效——最简单的办法，就是把 shell_cmd 里的整条命令复制出来，在终端里手动跑一遍。13万字C语言保姆级教程（深入）：立即使用
在学习笔记中，你将探索c语言的核心概念和高级技巧！
