很多刚开始学 C 语言的同学，装好 Sublime Text 3，兴致勃勃地把网上的示例代码抄进去，按下 Ctrl+B，底部面板哗啦冒出一堆英文，最后只看到一个刺眼的 error。然后就开始怀疑是不是自己的代码写错了。其实大部分情况根本不是代码的问题，而是你还没有把 C 语言的“运行环境”理顺。

“Sublime Text 3 配置 C 语言运行环境”这件事，拆开看其实是三件事：装一个能用的 C 编译器、把编译器的路径告诉系统、再给 Sublime Text 写一个构建配置。只要你理解了这三层关系，剩下的一切都会顺理成章。这篇内容适合刚接触 C 语言、想留在轻量编辑器里写代码的同学，也适合被网上教程绕晕、最后连一个 hello world 都没跑起来的人。照着下面的步骤走，大部分问题都能一次解决。

1. 先把底层逻辑理清楚：编辑器 ≠ 编译器

1.1 为什么不能直接在 Sublime Text 里“运行”C 程序

一句话概括：Sublime Text 是文本编辑器，不是 IDE。它负责写字，不负责编译，更不负责把程序跑起来。C 是编译型语言，源代码需要经过预处理、编译、汇编、链接这几个阶段，变成操作系统能直接执行的可执行文件，才能运行。Sublime Text 能做的，最多是替你把“编译”这条命令包装成一个按钮。

拿 Windows 举例：按下 Ctrl+B 的时候，Sublime Text 背后实际执行的是 gcc.exe 这样的编译器命令。前提是系统里有这个命令，并且能在环境变量 PATH 里找到它。如果你没有装编译器，或者装了但不会调用，按多少次 Ctrl+B 都只会得到一个“找不到命令”的提示。

这里有个非常常见的理解误区：有人以为“装了 Sublime Text，再装一个叫 C 语言的插件，就能运行了”。真不是这样。你需要的是一套独立的 C 工具链，它和你用什么编辑器没有任何关系。干脆做一个验证：先在命令行里用 gcc hello.c -o hello 编译成功，再去折腾 Sublime Text 里的构建配置。命令行能跑通的事，编辑器里才有配置的意义。

1.2 所谓“运行环境”到底由哪几部分组成

把“运行环境”拆开看，大概就是三部分：

• 编译器：把 .c 源文件变成目标文件。Windows 上常用 MinGW-w64 里的 gcc，macOS 自带的是 clang，Linux 各发行版用的是系统 gcc。
• 链接器与标准库：目标文件要和 C 标准库（比如 printf、scanf 背后的实现）链接在一起，才能生成最终的可执行文件。链接环节出错时，典型报错是 undefined reference。
• 构建系统：这是 Sublime Text 一侧的东西。它是一份配置文件，告诉编辑器“按 Ctrl+B 时执行哪条命令、用什么参数、在哪个目录下干活、编译输出怎么解析”。

搞清楚这个分工之后，你再去看网上那些眼花缭乱的教程，就知道他们为什么一会儿让你装 MinGW，一会儿让你建 .sublime-build 文件了。前者是补工具链，后者是写控制脚本，它们各管各的，谁也不能替代谁。

2. 环境准备：把编译器装好、告诉系统它在哪

2.1 Windows 下 MinGW-w64 的安装：别再用旧版 MinGW

Windows 上没有自带 C 编译器，所以必须手动装。网上搜 MinGW，很容易搜到“MinGW.org”这个老项目，它的 gcc 还停留在 4.x 年代，C 标准支持落后，维护状态也比较尴尬。新写的代码、新做的项目，一律建议用 MinGW-w64。

我推荐两种安装方式，任选其一。

第一种是直接用免安装压缩包。有一个叫 WinLibs 的项目，专门打包了完整的 MinGW-w64 工具链，下载对应 x86_64 的 64 位版本，解压到比如 C:\mingw64，然后把 C:\mingw64\bin 添加进环境变量 PATH。这个方式干净、不跑安装器，但需要手动设置环境变量，对新手有点门槛。

第二种是用 MSYS2 这个包管理器。装好 MSYS2 之后，在它的终端里执行：

pacman -S mingw-w64-x86_64-gcc

装好的 gcc.exe 一般在 C:\msys64\mingw64\bin。同样把这个目录加进 PATH。MSYS2 的好处是以后装其他开发工具非常方便，比如 make、gdb、git 在 Windows 上的编译依赖，都可以一条命令搞定；缺点是目录结构对新手来说有点绕，bin 目录的位置容易找错。

如果下载安装器的时候遇上各种选项，记住这几个选择标准就够了：

• 架构选 x86_64，除非你的系统是 32 位的。
• 线程模型选 posix 还是 win32：普通课程作业、不碰多线程的话差别不大；如果后面要学 pthread，posix 的可移植性更好。
• 异常处理选 seh 还是 dwarf：64 位系统建议 seh，稳定性更好；32 位编译器才需要纠结 dwarf。

这一步真的不需要想太多。能编译，版本不太老，就合格了。我用 MSYS2 里面的默认 gcc 用了很长时间，没遇到任何教学场景解决不了的问题。

2.2 macOS 和 Linux 的编译器怎么弄

macOS 系统里其实已经有 clang，但它默认不带命令行工具。在终端里执行：

xcode-select --install

系统会弹窗提示安装，等它装完，再执行 clang --version 或者 gcc --version，能看到版本信息就说明环境通了。macOS 上的 gcc 命令其实是指向 clang 的软链接，这不影响我们日常编译 C 程序，教学场景完全够用。

Linux 各发行版更省事。Debian/Ubuntu 系列执行：

sudo apt install gcc

CentOS/RHEL/Fedora 系列执行：

sudo dnf install gcc

装完在终端里 gcc --version 验证一下。Linux 本身就是 C 语言的主场，系统工具链很完整，基本不需要折腾 PATH。

2.3 环境变量是进程启动时读一次的，不是改完立刻生效

Windows 下改完 PATH 之后，最容易翻车的现场就是：你新开了一个 cmd，输入 gcc --version，依然提示“不是内部或外部命令”。原因十有八九是你改的是系统变量还是用户变量没改对，或者你当前打开的 cmd、Sublime Text 都是改 PATH 之前启动的进程，环境变量在进程启动时只读取一次，不会自动刷新。

正确做法是：改完 PATH 后，把所有 cmd 窗口全部关闭，把 Sublime Text 也彻底退出，重新打开，再来验证。先在 cmd 里确认这一步：

gcc --version

看到类似gcc (MinGW-W64 x86_64-posix-seh) 13.2.0的输出，编译器才算真正就绪。这一步必须通过，因为 Sublime Text 里的构建系统本质上是替你调用命令行，命令行里找不到的东西，Sublime Text 里也一定找不到。

还有个容易忽略的点：如果你系统里装过多个编译器，比如装了旧版 MinGW 又装了 MSYS2，PATH 里谁排前面，gcc 指向的就是谁。排查诡异报错的时候，先看看 gcc --version 到底输出的是哪个版本，我因为这个踩过多次坑。

3. 在 Sublime Text 3 里写一个 C 构建配置

3.1 构建系统是什么？把它当成一个“快捷键配置”

Sublime Text 的构建系统（Build System）本质上就是一个 JSON 格式的配置文件，告诉编辑器按下 Ctrl+B 之后执行什么命令。你可以通过菜单 Tools → Build System → New Build System... 新建一个，会打开一个模板文件。把内容改成下面这版，然后保存为 C.sublime-build。

保存位置不用手动操心，默认就在 User 目录。Windows 上对应%APPDATA%\Sublime Text 3\Packages\User\C.sublime-build，macOS 上对应~/Library/Application Support/Sublime Text 3/Packages/User/C.sublime-build。放在 User 目录下的配置文件，Preferences 菜单里能看到，方便统一管理。

3.2 一版可以直接用的 C.sublime-build，逐行讲清楚

{ "cmd": ["gcc", "$file", "-o", "${file_path}/${file_base_name}", "-std=c11", "-Wall", "-Wextra", "-g"], "file_regex": "^(...*?):([0-9]+):?([0-9]+)?:? (.*)$", "selector": "source.c", "working_dir": "${file_path}", "shell": false }

逐行解释一下：

• "cmd"数组是整个配置文件的核心。第一项 gcc 是命令，后面每一项都是传给 gcc 的参数。$file是当前源文件的完整路径，Sublime Text 会自动替换这个变量。-o指定输出文件，${file_path}/${file_base_name}的意思是“在源文件所在目录，生成一个和源文件同名、没有扩展名的可执行文件”。例如 hello.c 会生成 hello.exe（Windows 上 gcc 自动补上 .exe 后缀）。-std=c11固定使用 C11 标准，避免某些老编译器默认标准太旧。-Wall -Wextra打开常见的警告信息，警告不是错误，但能提前替你发现很多潜在问题。-g生成调试信息，以后想用 gdb 调试时不需要重新编译。
• "file_regex"是从编译输出中定位错误位置的“翻译规则”。gcc 报错格式通常是 hello.c:3:5: error: ...，这个正则负责把文件名、行号、列号、消息内容提取出来，这样你才能在面板里用 F4 快捷跳转到出错的那一行。
• "selector"是自动匹配规则，值是 source.c，表示当前编辑 .c 文件时，Sublime Text 会自动选用这份构建配置，不用每次手动切。
• "working_dir"设置工作目录为源码所在目录。这样程序里若有用相对路径读写文件的逻辑，不会因为当前目录不对而找不到文件。
• "shell": false表示直接以数组方式调用命令，不经过系统 shell。这个细节很重要，它避免了你写的路径里如果有空格，被 shell 错误拆分成多个参数。

3.3 几个我踩过坑的细节

第一，保存后必须重新选中一次构建系统。Tools → Build System 菜单里，确认勾选的是 C。只保存配置文件，不会自动让快捷键生效，至少我不会这么顺利，经常要手动点一次才放心。

第二，cmd 数组里的每一项尽量写成独立元素，不要拼成一个长字符串。比如"gcc $file -o ..."这种写法，一旦工程目录名里有空格，比如 My Project，shell 会把 My 和 Project 当成两个参数，直接炸掉。数组写法能天然避免这个坑，这是新手最容易崩溃的地方。

第三，文件命名建议用英文。Sublime Text 本身能处理中文文件名，但编译器、终端在部分 Windows 环境下遇到中文路径会出各种玄学报错。不是绝对不能，但没必要给自己添堵。

4. 实操：编译、运行、读懂输出

4.1 让第一个 C 程序完整跑通

新建一个文件 hello.c，写入：

#include <stdio.h> int main(void) { printf("hello world\n"); return 0; }

确保 Tools → Build System 里选的是 C，然后按 Ctrl+B。如果一切正常，底部面板只会出现一行 “Finished with exit code 0”，干净利落。

这时去源码目录看一眼，你会发现多了一个 hello.exe（Windows）或者 hello（macOS/Linux）。这个文件就是编译产物。在 Windows 的 cmd 里 cd 到该目录，输入：

hello.exe

就能看到输出。这一步标志着你的“Sublime Text + C 编译器”链路彻底打通了。

注意一个区别：Ctrl+B 只负责编译，它不会运行程序。你别以为编译成功就等于运行成功，这是两个阶段。很多同学编译通过后看不到输出，就开始怀疑配置，其实只是没运行而已。想要一键“编译 + 运行”，需要给构建系统加变体，这个后面会专门讲。

4.2 编译输出怎么读，错误行怎么跳

编译器不可能永远不出错，学会读编译输出比学会写代码还早。gcc 的报错信息格式非常固定，比如：

hello.c:3:5: error: expected ';' before '}' token

拆开看：hello.c 是文件名，3 是行号，5 是列号，后面是错误描述。有了file_regex那份配置，Sublime Text 就能把这些信息解析出来，面板里用 F4 跳下一个错误，Shift+F4 跳上一个错误，非常顺手。

需要分清 error 和 warning。error 是编译直接失败，必须改掉；warning 是编译器觉得可疑但还是放行了，比如定义了一个变量但没使用。-Wall -Wextra的意义就在这里，它会把很多隐患提前暴露出来。我的习惯是：警告也尽量清零，因为 90% 的警告背后都藏着一个早晚会爆的 bug。

4.3 最大的坑：scanf 没法输入

这是刚上手时最迷惑的问题。你写了一个带 scanf 的程序，在命令行里编译运行完全正常，但放回 Sublime Text 按“运行”，界面好像卡死了，怎么按都没反应。

原因很简单：Sublime Text 的面板是只读的输出区，它只显示程序打印出来的内容，不支持往正在运行的程序里输入任何东西。scanf 在等你敲键盘，但你的键盘输入根本没地方送进去，程序自然就“卡住”了。

这个问题的终极解法是让程序在一个外部终端窗口里运行，我放在第 6 节详细讲。临时解法也很简单：编译之后，自己去系统终端里执行生成的 exe，交互输入的问题立刻消失。

5. 常见问题排查与避坑实录

5.1 “gcc 不是内部或外部命令”

这是出现频率最高的一条。按顺序排查：

• 打开 cmd，输入 gcc --version。如果 cmd 里也提示不存在，说明环境变量 PATH 没配好，或者配的是另一个目录。
• 确认 bin 目录路径写对了。MSYS2 的话，是 C:\msys64\mingw64\bin，不是 C:\msys64\usr\bin，这两个目录里的编译器不是同一个世界的东西。
• 确认环境变量是“用户变量”还是“系统变量”。如果是用户变量，一些以管理员身份运行的终端可能读不到；如果是系统变量，需要管理员权限修改。
• 改完 PATH 之后，必须彻底关闭并重开 cmd 和 Sublime Text。这个我前面强调过一次，但要反复踩踩才能长记性。

这条问题的本质是：Sublime Text 是在启动时读取环境变量并继承到子进程里的，所以改 PATH 后不重启编辑器，它永远找不到你新装的 gcc。

5.2 编译成功，但 exe 一闪而过

在命令行里手动运行 exe，程序执行完之后窗口马上关闭，你还没来得及看输出。这其实不是编译器的锅，是控制台窗口的特性：进程结束了，窗口就跟着关了。

网上常见的土办法是在 main 函数结尾加 system("pause")，Windows 下确实能暂停住。但我不推荐把它写进正式代码里，它会让程序失去可移植性，也会污染你以后写项目时的习惯。更干净的做法是：不要双击 exe，而是先在 cmd 里切到源码目录，再手动执行；或者用后面第 6 节的外部终端方案，窗口关不关完全由你自己控制。

5.3 中文乱码

Windows 下最常见的乱码场景是：源码文件是 UTF-8 编码，程序里 printf 输出中文，控制台默认代码页是 GBK（936），两边对不上，显示出来就是一堆符号。

处理办法有几个：

• 在外部终端里运行前先执行 chcp 65001，把代码页切到 UTF-8，再运行程序。
• 保存源码文件时用 GBK 编码，Sublime Text 右下角可以改编码，但不建议，因为和主流工具链的默认编码习惯反着来。
• 学习阶段干脆用英文输出，省去编码问题，专