很多刚开始学 C 语言的同学装好 Sublime Text 3兴致勃勃地把网上的示例代码抄进去按下 CtrlB底部面板哗啦冒出一堆英文最后只看到一个刺眼的 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 举例按下 CtrlB 的时候Sublime Text 背后实际执行的是 gcc.exe 这样的编译器命令。前提是系统里有这个命令并且能在环境变量 PATH 里找到它。如果你没有装编译器或者装了但不会调用按多少次 CtrlB 都只会得到一个“找不到命令”的提示。这里有个非常常见的理解误区有人以为“装了 Sublime Text再装一个叫 C 语言的插件就能运行了”。真不是这样。你需要的是一套独立的 C 工具链它和你用什么编辑器没有任何关系。干脆做一个验证先在命令行里用 gcc hello.c -o hello 编译成功再去折腾 Sublime Text 里的构建配置。命令行能跑通的事编辑器里才有配置的意义。1.2 所谓“运行环境”到底由哪几部分组成把“运行环境”拆开看大概就是三部分编译器把 .c 源文件变成目标文件。Windows 上常用 MinGW-w64 里的 gccmacOS 自带的是 clangLinux 各发行版用的是系统 gcc。链接器与标准库目标文件要和 C 标准库比如 printf、scanf 背后的实现链接在一起才能生成最终的可执行文件。链接环节出错时典型报错是 undefined reference。构建系统这是 Sublime Text 一侧的东西。它是一份配置文件告诉编辑器“按 CtrlB 时执行哪条命令、用什么参数、在哪个目录下干活、编译输出怎么解析”。搞清楚这个分工之后你再去看网上那些眼花缭乱的教程就知道他们为什么一会儿让你装 MinGW一会儿让你建 .sublime-build 文件了。前者是补工具链后者是写控制脚本它们各管各的谁也不能替代谁。2. 环境准备把编译器装好、告诉系统它在哪2.1 Windows 下 MinGW-w64 的安装别再用旧版 MinGWWindows 上没有自带 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普通课程作业、不碰多线程的话差别不大如果后面要学 pthreadposix 的可移植性更好。异常处理选 seh 还是 dwarf64 位系统建议 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 gccCentOS/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 又装了 MSYS2PATH 里谁排前面gcc 指向的就是谁。排查诡异报错的时候先看看 gcc --version 到底输出的是哪个版本我因为这个踩过多次坑。3. 在 Sublime Text 3 里写一个 C 构建配置3.1 构建系统是什么把它当成一个“快捷键配置”Sublime Text 的构建系统Build System本质上就是一个 JSON 格式的配置文件告诉编辑器按下 CtrlB 之后执行什么命令。你可以通过菜单 Tools → Build System → New Build System... 新建一个会打开一个模板文件。把内容改成下面这版然后保存为 C.sublime-build。保存位置不用手动操心默认就在 User 目录。Windows 上对应%APPDATA%\Sublime Text 3\Packages\User\C.sublime-buildmacOS 上对应~/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}, -stdc11, -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.exeWindows 上 gcc 自动补上 .exe 后缀。-stdc11固定使用 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 Projectshell 会把 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然后按 CtrlB。如果一切正常底部面板只会出现一行 “Finished with exit code 0”干净利落。这时去源码目录看一眼你会发现多了一个 hello.exeWindows或者 hellomacOS/Linux。这个文件就是编译产物。在 Windows 的 cmd 里 cd 到该目录输入hello.exe就能看到输出。这一步标志着你的“Sublime Text C 编译器”链路彻底打通了。注意一个区别CtrlB 只负责编译它不会运行程序。你别以为编译成功就等于运行成功这是两个阶段。很多同学编译通过后看不到输出就开始怀疑配置其实只是没运行而已。想要一键“编译 运行”需要给构建系统加变体这个后面会专门讲。4.2 编译输出怎么读错误行怎么跳编译器不可能永远不出错学会读编译输出比学会写代码还早。gcc 的报错信息格式非常固定比如hello.c:3:5: error: expected ; before } token拆开看hello.c 是文件名3 是行号5 是列号后面是错误描述。有了file_regex那份配置Sublime Text 就能把这些信息解析出来面板里用 F4 跳下一个错误ShiftF4 跳上一个错误非常顺手。需要分清 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 输出中文控制台默认代码页是 GBK936两边对不上显示出来就是一堆符号。处理办法有几个在外部终端里运行前先执行 chcp 65001把代码页切到 UTF-8再运行程序。保存源码文件时用 GBK 编码Sublime Text 右下角可以改编码但不建议因为和主流工具链的默认编码习惯反着来。学习阶段干脆用英文输出省去编码问题专 
长河君 · 2026/10/21 21:52:48 · 阅读 1.2k C语言新手必看：Sublime Text 3运行环境配置指南
很多刚开始学 C 语言的同学装好 Sublime Text 3兴致勃勃地把网上的示例代码抄进去按下 CtrlB底部面板哗啦冒出一堆英文最后只看到一个刺眼的 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 举例按下 CtrlB 的时候Sublime Text 背后实际执行的是 gcc.exe 这样的编译器命令。前提是系统里有这个命令并且能在环境变量 PATH 里找到它。如果你没有装编译器或者装了但不会调用按多少次 CtrlB 都只会得到一个“找不到命令”的提示。这里有个非常常见的理解误区有人以为“装了 Sublime Text再装一个叫 C 语言的插件就能运行了”。真不是这样。你需要的是一套独立的 C 工具链它和你用什么编辑器没有任何关系。干脆做一个验证先在命令行里用 gcc hello.c -o hello 编译成功再去折腾 Sublime Text 里的构建配置。命令行能跑通的事编辑器里才有配置的意义。1.2 所谓“运行环境”到底由哪几部分组成把“运行环境”拆开看大概就是三部分编译器把 .c 源文件变成目标文件。Windows 上常用 MinGW-w64 里的 gccmacOS 自带的是 clangLinux 各发行版用的是系统 gcc。链接器与标准库目标文件要和 C 标准库比如 printf、scanf 背后的实现链接在一起才能生成最终的可执行文件。链接环节出错时典型报错是 undefined reference。构建系统这是 Sublime Text 一侧的东西。它是一份配置文件告诉编辑器“按 CtrlB 时执行哪条命令、用什么参数、在哪个目录下干活、编译输出怎么解析”。搞清楚这个分工之后你再去看网上那些眼花缭乱的教程就知道他们为什么一会儿让你装 MinGW一会儿让你建 .sublime-build 文件了。前者是补工具链后者是写控制脚本它们各管各的谁也不能替代谁。2. 环境准备把编译器装好、告诉系统它在哪2.1 Windows 下 MinGW-w64 的安装别再用旧版 MinGWWindows 上没有自带 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普通课程作业、不碰多线程的话差别不大如果后面要学 pthreadposix 的可移植性更好。异常处理选 seh 还是 dwarf64 位系统建议 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 gccCentOS/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 又装了 MSYS2PATH 里谁排前面gcc 指向的就是谁。排查诡异报错的时候先看看 gcc --version 到底输出的是哪个版本我因为这个踩过多次坑。3. 在 Sublime Text 3 里写一个 C 构建配置3.1 构建系统是什么把它当成一个“快捷键配置”Sublime Text 的构建系统Build System本质上就是一个 JSON 格式的配置文件告诉编辑器按下 CtrlB 之后执行什么命令。你可以通过菜单 Tools → Build System → New Build System... 新建一个会打开一个模板文件。把内容改成下面这版然后保存为 C.sublime-build。保存位置不用手动操心默认就在 User 目录。Windows 上对应%APPDATA%\Sublime Text 3\Packages\User\C.sublime-buildmacOS 上对应~/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}, -stdc11, -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.exeWindows 上 gcc 自动补上 .exe 后缀。-stdc11固定使用 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 Projectshell 会把 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然后按 CtrlB。如果一切正常底部面板只会出现一行 “Finished with exit code 0”干净利落。这时去源码目录看一眼你会发现多了一个 hello.exeWindows或者 hellomacOS/Linux。这个文件就是编译产物。在 Windows 的 cmd 里 cd 到该目录输入hello.exe就能看到输出。这一步标志着你的“Sublime Text C 编译器”链路彻底打通了。注意一个区别CtrlB 只负责编译它不会运行程序。你别以为编译成功就等于运行成功这是两个阶段。很多同学编译通过后看不到输出就开始怀疑配置其实只是没运行而已。想要一键“编译 运行”需要给构建系统加变体这个后面会专门讲。4.2 编译输出怎么读错误行怎么跳编译器不可能永远不出错学会读编译输出比学会写代码还早。gcc 的报错信息格式非常固定比如hello.c:3:5: error: expected ; before } token拆开看hello.c 是文件名3 是行号5 是列号后面是错误描述。有了file_regex那份配置Sublime Text 就能把这些信息解析出来面板里用 F4 跳下一个错误ShiftF4 跳上一个错误非常顺手。需要分清 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 输出中文控制台默认代码页是 GBK936两边对不上显示出来就是一堆符号。处理办法有几个在外部终端里运行前先执行 chcp 65001把代码页切到 UTF-8再运行程序。保存源码文件时用 GBK 编码Sublime Text 右下角可以改编码但不建议因为和主流工具链的默认编码习惯反着来。学习阶段干脆用英文输出省去编码问题专