Sublime Text 3 配置 C 语言运行环境：MinGW 与构建系统

Sublime Text 3 配置 C 语言运行环境这件事看起来已经被写烂了但我最近又帮几个刚学 C 语言的朋友配了一遍发现网上很多教程要么只给一段.sublime-build代码要么让你装一堆插件实际用起来各种诡异问题编译成功却不出结果、程序要输入时控制台卡住、中文输出乱码……问题全在“只贴配置不讲原理”。这篇就来点实在的。我的思路很简单Sublime Text 3 本质上是一个编辑器它既不编译 C 代码也不负责运行程序你需要手动告诉它“用哪个编译器、怎么编译、编译完去哪执行”。把这套逻辑理顺了剩下的就是填参数。适合的场景也很明确课程作业、算法刷题、小工具开发以及那些就是不想打开笨重 IDE 的人。读完这篇文章你不仅能复现一套能用的环境还能知道每个配置项在干什么以后出问题能自己排。1. 先把思路理清楚Sublime Text 3 到底缺什么1.1 编辑器不负责“运行”这件事很多人第一次用 Sublime Text 3 写 C 语言都会下意识按CtrlB然后以为能看到类似 IDE 那样的编译运行效果。结果看到的只是一个空空的执行面板或者直接提示找不到命令于是得出结论这编辑器不行。问题不在编辑器身上而在你对工具的预期上。Sublime Text 3 是文本编辑器它的职责是让你舒服地写代码语法高亮、自动补全、多光标编辑、快速跳转。它不内置编译器也不解析 C 语言的printf、scanf更不会帮你链接库文件。这些东西属于另一个完全独立的工具链通常叫“编译器”和“链接器”。在 Windows 上最常见的 C 语言编译器是 GCC而 GCC 本身又是一个命令行程序它吃进去的是xxx.c源文件吐出来的是xxx.exe可执行文件。Sublime Text 3 要做的只是在你按下快捷键后替你打开命令行、执行 GCC、然后把输出抓回来显示。这就是“Build System构建系统”干的事编辑器和你本地的编译工具之间的一座桥。理解到这层你再看网上的各种配置文件就不会两眼一抹黑了。所有的.sublime-build文件核心就是一段“外部命令调用清单”。1.2 为什么我仍推荐用轻量编辑器写 C有人会问既然要做 C 语言开发直接用 Visual Studio 或 CLion 不香吗当然香尤其适合大型项目、需要图形化调试、依赖管理复杂的场景。但很多人的真实需求没那么重课上交个作业、刷两道算法题、写个几百行的课程设计这时候 IDE 的缺点就暴露了——启动慢、索引卡、提示一堆你用不上的功能。Sublime Text 3 在这个场景下的优势是实打实的秒开、内存占用低、界面干净。我用它写 C 写了很多年最舒服的一点是没有杂音。打开就是一个空窗口光标等着你写完CtrlB看结果整个过程非常顺。配置好的构建系统就像一条专用通道按一下就编译运行比在 IDE 里点一堆按钮快得多。还有一个容易被忽略的点用命令行工具链写 C你对“编译、链接、执行”这三个概念的理解会更扎实。因为你亲手把它们拆开了——编辑器负责写代码GCC负责编译cmd窗口负责运行。反而用 IDE 的时候这些步骤被自动化得太彻底很多人编译报错都不知道去哪看细节。1.3 这套配置方案的整体架构先给你一张全貌图免得后面迷失方向层次角色对应工具编辑层写代码Sublime Text 3编译层把 .c 变成 .exeMinGW-w64 自带的 GCC执行层运行 .exe 并显示结果Windows 的 cmd 控制台粘合层把以上串起来自定义 .sublime-build 构建系统后面所有步骤都是围绕这张表展开的。编辑器你有控制台系统自带真正要装的就是 MinGW-w64 编译器以及一份能指挥它们协作的配置文件。2. 编译器才是重头戏MinGW-w64 环境准备2.1 到底选哪个版本MinGW-w64 而不是老版 MinGW很多教程告诉你“安装 MinGW”但等你真去下载会发现两个名字长得差不多的东西MinGW 和 MinGW-w64。MinGW 是老项目常年停留在 32 位GCC 版本也比较旧MinGW-w64 是它的后继分支支持 64 位也能编译 32 位程序GCC 版本持续更新。现在新电脑装 MinGW-w64 基本是共识老教程里的 MinGW 可以忽略。进入 MinGW-w64 的下载页或者从 SourceForge 进入你会看到一堆压缩包后缀有x86_64和i686的区别。简要选择原则x86_64是 64 位版本的 GCCi686是 32 位版本。现在的新电脑直接用x86_64。线程模型中有posix和win32两种后缀。posix版本支持 C 标准线程库对 C 语言影响不大但为了以后可能要写的 C 代码选posix更稳妥。异常处理模型有seh和sjlj。seh是 64 位下的推荐方案性能更好sjlj兼容性更强但对 64 位程序没有额外优势。所以选x86_64-posix-seh即可。有点绕但你只要记住一句话下最新发布的x86_64-posix-seh版本直接解压不要费劲去看那些差异对比表。2.2 下载、解压与验证的两分钟速成下载回来的压缩包不用安装它是一套便携式工具链解压就能用这本来是件好事但有个关键注意点解压路径不要带中文、不要带空格。老版 GCC 对路径里的中文和空格处理得不好虽然新版已经改善但没必要给自己挖坑。我习惯放在C:\mingw64路径短、干净、好记。解压完成后你会在C:\mingw64\bin目录下看到gcc.exe、g.exe、gdb.exe等一系列可执行文件。接下来把它加进系统环境变量让 Sublime Text 3 在任意路径下都能找到gcc。打开 Windows 设置搜索“环境变量”找到“系统变量”中的Path点击编辑新增一行C:\mingw64\bin确定保存。这里说一下为什么建议加到“系统变量”而不是“用户变量”Sublime Text 3 如果是从管理员权限运行时用户变量可能没被继承到配置好系统变量能少很多玄学问题。注意改完环境变量后要重新打开 Sublime Text 3它不会自己刷新环境变量。验证环境是否配置成功打开一个新的 cmd 窗口输入gcc --version如果看到一堆版本信息而不是“不是内部或外部命令”说明编译器已经就位了。到这一步重头戏已经完成剩下的工作都在 Sublime Text 3 里折腾。提示如果gcc --version报错不要急着往下配。检查路径、检查变量名、检查有没有重新打开终端。这个环节没做好后面所有配置都会失败。3. 配置编译系统一劳永逸的 C.sublime-build3.1 新建编译系统的入口在 Sublime Text 3 中菜单栏找到Tools Build System New Build System...点击后会打开一个编辑窗口里面已经有一小段默认的 JSON 模板。此时不要管它直接全选删除替换成我下面给的内容。保存时Sublime Text 会默认把文件放进Packages/User/目录文件名建议改成C.sublime-build。注意后缀必须是.sublime-build文件名用 C 就行。保存完成后去Tools Build System菜单下看一眼应该已经能看到C这个选项了。如果你当前编辑的文件是.c文件Sublime Text 会根据构建系统中的selector字段自动选中它这也就是为什么selector要写source.c的原因之一。如果你之前用过其他编辑器配置可能觉得这个文件的后缀很眼熟。没错Sublime Text 的 Build System 就是一种 JSON 格式的“任务定义”它规定了按下编译快捷键时要跑什么命令。3.2 一份能直接用的配置下面这份配置我实测过很多次覆盖了“只编译”和“编译并运行”两种场景运行时的输出会放到独立的 cmd 窗口里顺便解决了scanf无法输入的问题。直接复制{ cmd: [gcc, $file, -o, ${file_path}/${file_base_name}], file_regex: ^(..[^:]*):([0-9]):?([0-9])?:? (.*)$, working_dir: ${file_path}, selector: source.c, variants: [ { name: 运行, cmd: [cmd, /c, gcc \$file\ -o \${file_path}/${file_base_name}\ \${file_path}/${file_base_name}\] }, { name: 运行(可输入), cmd: [cmd, /c, gcc \$file\ -o \${file_path}/${file_base_name}\ start \运行\ cmd /k \${file_path}/${file_base_name}\] } ] }这份配置看起来有点长挨个解释一下cmd默认构建命令。gcc是编译器$file是当前正在编辑的.c文件的完整路径-o指定输出文件名${file_path}/${file_base_name}会把生成的.exe放在源文件同一个目录下文件名和源文件相同。file_regex用于解析 GCC 编译报错的格式让 Sublime Text 能识别“第几行第几列报错”并且在输出面板里直接点击跳转到对应代码位置。working_dir工作目录设为源文件所在目录避免程序运行时找不到相对路径下的文件。selector限定这个构建系统只对 C 语言源文件生效。variants额外定义两个变体类似 IDE 里的“运行”按钮。3.3 每个配置项的作用cmd中最容易被忽略的是$file和${file_path}这类“变量”。Sublime Text 内置了一系列变量$file是当前文件完整路径$file_path是目录路径$file_base_name是不带扩展名的文件名。写路径的时候带上这些变量就不用每次手动指定源文件了。file_regex这段正则表达式值得多说几句。GCC 的报错格式一般是这样的main.c(5): error: expected ; before return正则^(..[^:]*):([0-9]):?([0-9])?:? (.*)$就是把“文件名”“行号”“列号”“错误信息”拆出来然后 Sublime Text 3 才能把错误跳转到正确位置。如果你把它删了编译报错也能显示但你在输出面板里不能直接点击跳到代码只能靠自己手动翻到对应行体验差很多。variants是很多人容易忽略的部分。默认情况下CtrlB只会跑cmd里的命令也就是“只编译不运行”。想运行你需要按CtrlShiftB然后从下拉框里选“运行”或者“运行(可输入)”。这种设计与 IDE 有点区别但实际上更符合命令行直觉编译是编译运行是运行什么时候想跑你自己控制。4. 一条龙实操从写代码到弹出运行窗口4.1 编译与运行的按键操作假设你已经把上面的配置保存好了也打开了一个.c文件。现在按CtrlBSublime Text 3 底部的执行面板会弹出来里面会显示类似这样的内容gcc C:\test\hello.c -o C:\test\hello [Finished in 0.2s]只要没有红色报错信息说明编译成功源文件同目录下已经生成了hello.exe。注意这一步只会生成 exe不会弹出窗口显示结果。想看到运行结果按CtrlShiftB在弹出的下拉框里选择“运行”。这时你会看到结果直接显示在 Sublime Text 3 的执行面板里适合那种不涉及输入的简单程序。这个流程我建议养成习惯写代码、CtrlB检查语法和编译错、没问题再CtrlShiftB运行。比 IDE 的一键运行多一步但换来的是更清楚“编译”和“运行”是两个阶段。提示执行面板里的编译输出如果报错点击错误行可以直接跳到源码对应位置。这是配置file_regex的功劳别浪费这个功能。4.2 解决 scanf 输入问题让程序跑在独立窗口里很多人配置完发现一个大坑程序里有scanf运行时确实执行了但光标不动输入任何字符都没反应最后只能强制关闭。原因是执行面板本身没有“标准输入”的通道Sublime Text 3 的 exec 面板只是单向展示输出它不会把自己的面板当作键盘输入源。解决思路也很直接不让程序在 Sublime 的执行面板里运行而是把它丢给 Windows 的一个独立 cmd 窗口。这正是配置里“运行(可输入)”这个变体干的事。它做的事情是先用 GCC 编译编译成功后再调用start命令打开一个新窗口运行 exe。因为是一个真正独立的控制台窗口所以scanf、getchar这些输入函数都能正常工作。具体操作不变CtrlShiftB这次选“运行(可输入)”这个变体。你会发现程序在一个新弹出的 cmd 窗口里跑输入输出都正常。再加上cmd /k参数程序执行完毕后窗口不会自动关闭你可以慢慢看输出结果再按任意键关掉。如果一个程序本身不需要输入用哪个变体都行但我习惯统一用“运行(可输入)”因为输出不会夹在 Sublime 面板里看起来更清爽。4.3 处理中文乱码与编码问题中文乱码是 C 语言初学者最容易撞上的问题之一。原因其实不复杂GCC 默认按 UTF-8 理解源代码中的字符串但 Windows 控制台默认代码页是 GBK代码页 936两边编码不一致输出自然就成了乱码。有几个解法按推荐顺序排列在代码开头加上一句system(chcp 65001);作用是把当前控制台代码页切换到 UTF-8 编码。这种做法最简单缺点是每次运行都会多打一行“Active code page: 65001”之类的内容不介意的无所谓。用“运行(可输入)”变体把程序放到独立 cmd 窗口然后在窗口标题栏右键进入默认值设置把代码页改成 65001。改一次以后所有窗口都生效。如果你的使用场景比较固定也可以直接把源代码文件编码存成 GBK用 Sublime Text 3 的File Reopen with Encoding GBK来打开和保存。但我不推荐这个做法时代发展方向是 UTF-8能不改就别改。我在实际使用中发现最省心的是在代码里直接加system(chcp 65001);虽然丑了点但对新手来说最不容易出错。等以后你熟悉了命令行再去改控制台代码页也不迟。5. 常见问题排查与避坑实录5.1 “gcc 不是内部或外部命令”这大概是出现频率最高的问题。如果你按CtrlB后看到这句提示基本可以断定是环境变量没配好。检查顺序如下第一步先自己打开一个 cmd 窗口输入gcc --version。如果这一步都报错那就是环境变量的问题。去检查Path里有没有C:\mingw64\bin且路径指向的目录是不是真的存在。有时候你以为解压到了C:\mingw64实际上 Windows 的资源管理器自动解压出了嵌套目录比如C:\mingw64\mingw64\bin那路径自然就不对了。第二步如果 cmd 里能正常执行但 Sublime Text 3 里报错很大概率是环境变量在 Sublime 启动后没有被刷新。解决方法是完全关闭 Sublime Text 3 再重新打开包括所有窗口甚至可以去任务管理器里确认没有残留进程。第三步注意一些精简版 Windows 系统会把 cmd 的执行策略调得比较严格但大部分情况下跟这个无关。还有可能是你修改的是“用户变量”而 Sublime Text 3 是以管理员身份运行的。这种情况就改成“系统变量”或者在同一权限级别下再测一次。5.2 编译成功但没生成 exe编译面板显示成功但你到文件夹里找不到.exe文件。这种情况有个很常见的原因源文件根本没保存过。Sublime Text 3 里新建的文件如果不保存它的路径变量会是空的编译器拿到的输入参数就是空字符串编译结果自然不知道会躺到哪个角落去。另一个可能原因是working_dir或输出路径包含了中文或特殊字符导致生成文件失败但 GCC 没有直接报致命的错。我的习惯是项目文件夹和源文件名尽量用英文不是崇洋媚外纯粹是为了少踩压缩包、编译器的字符编码坑。如果你是用“运行”变体但运行后什么都没发生也可以检查一下是不是cmd数组里的命令拼接出了问题。这时候点开Tools Build System C然后在菜单栏的Tools Build Results Build里看一下完整输出或者直接在 cmd 里手动敲一遍编译命令很容易定位问题。5.3 编译报错但无法跳转到对应行GCC 报错信息倒是出来了但点击输出面板里的错误信息光标没有跳到源码对应位置。这个问题通常就是file_regex被删掉或者写错了。还有一种情况是你用了中文文件名。GCC 在输出错误信息时文件名里的中文字符被转码了导致正则匹配不到路径。解决办法很简单把源文件改成英文名再试。另外如果你的编译器实际输出格式跟默认正则不匹配可以自定义file_regex。一个很实用的排查方式故意在代码里写个语法错误执行编译然后看输出面板里的原始报错文本长什么样再照着调整正则表达式。5.4 其他坑点速查症状常见原因对策运行结果和源代码不一致编译的是旧文件或没保存先CtrlS保存再编译运行编译时提示找不到头文件MinGW 路径解析异常检查安装路径是否含空格或中文双击 exe 闪退程序跑完自动关闭窗口用“运行(可输入)”变体运行gcc 版本显示 32 位下错了i686包换x86_64版本重新配置运行变体没反应编译失败后面的命令没有执行先编译看有没有生成 exe其中“双击 exe 闪退”这个坑值得单独说。很多人编译成功后在文件夹手动双击 exe窗口一闪而过然后就以为程序没运行。其实程序正常跑完了只是窗口默认自动关闭。我用“运行(可输入)”变体就是因为它的cmd /k能保留窗口省去手动暂停的麻烦。5.5 一个容易被忽略的小技巧关于 Sublime Text 3 的版本当前网上还是能搜到大量 Sublime Text 2 的教程但 Sublime Text 3 的构建配置和 2 代有一些细微差别主要体现在变量命名和 JSON 解析上。如果你用的是 Sublime Text 3看到那种$file_path$file_name拼接的写法就要留意这是老版本的习惯并不一定能直接照抄。另外Sublime Text 4 也已经出了界面和操作习惯跟 3 几乎一致本文讲的这套配置在 4 代上同样适用。如果你还在用 3 代不用急着换如果你直接用 4 代上面的配置也不用改动。有一点要注意新版本对 JSON 格式更严格配置里每个键值对的逗号、引号都别漏写否则构建系统会直接加载失败。配置完成后我建议你花两分钟手动测一遍完整流程写一个带scanf的小程序保存编译用“运行(可输入)”跑一次确认能输入、能输出、中文不乱码。这套验证流程走完后面不管是课程作业还是刷算法题基本都是一路顺畅。我自己的经验是这套环境最值得称道的地方在于稳定一旦配置好几年都不用动不像 IDE 那样动不动更新换代、改界面、吃内存。Sublime Text 3 搭配 GCC轻、快、顺手特别适合把精力集中在代码本身的人。你如果还有编译报错信息想自动复制、或者想在 Sublime 里直接调出终端后面完全可以再装 Terminal、SideBarEnhancements 这类插件来扩展但那是后话了先把眼前这套跑通再说。