一键运行C代码的硬性前提是gcc已正确配置到PATH并能通过gcc --version验证；Windows需MinGW-w64勾选Add to PATH，macOS需xcode-select --install，Linux需安装build-essential；路径须纯英文无空格；C.sublime-build文件必须保存至Packages/User/目录并重启Sublime；含输入的程序需用Terminus插件或外部终端变体解决stdin限制。
能一键运行 C 代码的前提只有一个：gcc 必须在终端里直接敲 gcc --version 就能返回版本号。否则所有 Sublime 的配置都是空转，按 Ctrl+B 只会静默失败或报 'gcc' is not recognized 这类错误。
确认 gcc 已就绪且 PATH 正确
这不是“可选步骤”，而是硬性前置条件。Sublime 不自带编译器，它只负责把你的 ${file} 丢给系统命令行去跑。
- Windows 用户装 MinGW-w64 时，必须勾选 “Add to PATH”；装完后打开新 CMD，执行
gcc --version—— 如果提示“不是内部或外部命令”，说明 PATH 没生效，重启电脑或重装更省事 - macOS 用户别只装
brew install gcc，还要跑xcode-select --install补全 Command Line Tools，否则gcc可能调用失败或缺头文件 - Linux（Ubuntu/Debian）用户必须装
build-essential，光装gcc不够，glibc头文件和make等工具缺一不可 - 路径含中文或空格（如
C:\Program Files\mingw64\bin）会导致shell_cmd解析失败，建议重装到纯英文无空格路径，比如C:\mingw64\bin
写对 C.sublime-build 文件的关键字段
Build System 是 JSON 文件，不是脚本，字段名大小写、引号、逗号都不能错。最常出问题的是 shell_cmd 和 cmd 混用，以及 Windows 下漏掉 cmd /c。
- Windows 推荐用
shell_cmd字段，支持&&串联编译与运行："shell_cmd": "gcc -Wall -std=c17 \"${file}\" -o \"${file_path}/${file_base_name}\" && \"${file_path}/${file_base_name}\"" - macOS/Linux 更推荐
cmd数组写法，避免 shell 解析歧义："cmd": ["gcc", "-Wall", "-std=c17", "${file}", "-o", "${file_path}/${file_base_name}", "&&", "${file_path}/${file_base_name}"]—— 但注意：这行实际会失败，因为&&是 shell 特性，cmd数组默认不走 shell；正确写法是加"shell": true或改用shell_cmd -
working_dir必须设为"${file_path}"，否则生成的可执行文件可能落在奇怪位置，后续运行找不到 -
selector要写成"source.c"，不是"C"或"c"，否则 Sublime 不会自动关联该构建系统
解决运行时无法输入（scanf/cin 卡住）的问题
Sublime 自带输出面板是只读的，不提供 stdin 输入流。所以任何含 scanf 或 getchar 的程序，在默认 Build System 下都会卡死或跳过输入直接崩溃。
- 临时方案：用
variants加一个“外部终端运行”变体，Windows 示例："cmd": ["cmd", "/c", "gcc", "${file}", "-o", "${file_path}/${file_base_name}", "&&", "start", "cmd", "/c", "${file_path}/${file_base_name} & pause"] - macOS/Linux 可用
gnome-terminal或alacritty替代，但需确保终端命令已安装并可被 PATH 找到 - 更通用的解法是装
Terminus插件，它能在 Sublime 内嵌一个真正可交互的终端，配置"cmd"时指向gcc+./a.out即可 - 不要试图在
shell_cmd里加read或pause后再回传到 Sublime 面板——面板不响应键盘输入，这是架构限制，不是配置能绕过的
保存位置、启用方式与常见静默失败点
文件名和保存路径错了，Sublime 就压根看不到这个构建系统。而且即使文件存在，也不代表它已加载。
- 必须保存为
Packages/User/C.sublime-build（不是Packages/C/...，也不是桌面或文档目录） - 保存后，**必须重启 Sublime Text** —— GUI 应用不会热重载 PATH 或新 build 文件
- 写完代码后，先按
Ctrl+S保存文件（未保存的临时文件${file}为空字符串，导致 gcc 报no input files） - 手动在菜单
Tools → Build System中选中C，别依赖自动识别；如果列表里没出现，说明文件名或路径不对，或 JSON 有语法错误 - 如果输出面板只显示
[Finished in 0.1s]且无错误也无输出，大概率是shell_cmd编译成功但运行失败（比如可执行文件权限不足、路径含空格未加引号、或main()返回非零值被误判为失败）
真正麻烦的从来不是写 JSON，而是环境变量是否生效、路径是否被 shell 正确解析、以及 stdin 是否可用这三个层面的问题。每换一台机器或重装系统，都要重新验证这三点，而不是直接复制旧配置。
13万字C语言保姆级教程（深入）：立即使用
在学习笔记中，你将探索c语言的核心概念和高级技巧！
