简介：这份 Dev-C++ 中文版使用手册面向 C/C++ 编程初学者与课堂教学场景，帮助读者快速掌握这款可视化集成开发环境的基本用法，解决从新建源程序到调试排错的入门难题。资源包共 1 个文件，为 1.12MB 的 PDF 文档，内容以图文并茂的方式呈现，便于对照操作。手册系统梳理了启动软件、新建与保存源程序、预处理编译链接、运行程序以及断点调试等核心环节，并针对编译日志中词法、语法错误的定位方法、system("pause") 防止结果一闪而过、断点设置与单步执行等常见问题给出具体说明，还提醒读者在英文输入环境下编辑代码、养成随时保存的习惯。目前已有 312 人学习，适合刚接触 Dev-C++ 的学生按章节逐步练习，也可作为教师课堂演示的参考材料，帮助读者在较短时间内建立规范的编程操作流程与调试思路。
1. 从一份 dev-c++ 中文版使用手册说起：谁还在用它，为什么值得翻出来
如果你现在还在用 Dev-C++，大概率不是因为它有多先进，而是因为它够轻、够快、够省事。一个不到 50MB 的安装包，双击就能写 C/C++，编译运行一键完成，没有 CMake 配置，没有插件市场，没有登录账号。对于刚接触 C 语言的学生、需要快速验证一段算法的工程师、或者给老机器装个临时开发环境的人来说，这套组合拳依然有效。但问题也很明显：网上流传的所谓「dev-c++ 中文版使用手册.pdf」大多残缺不全，要么是机翻的界面截图，要么只讲菜单不讲配置，真正遇到编译报错、调试断点不生效、中文乱码时，翻遍手册也找不到答案。这篇内容就是把这些年我在 Dev-C++ 上踩过的坑、调过的参数、绕过的弯路，按一份能照着做的实战笔记整理出来。适合谁看：刚学 C 语言不想折腾环境的新手，需要维护老项目的从业者，以及想给教学场景找一个零配置 IDE 的老师。
2. Dev-C++ 中文版的环境搭建与编译器选型：别让第一步就翻车
2.1 为什么 Dev-C++ 的「中文版」其实分两种
很多人搜 dev-c++ 中文版，下载下来发现界面还是英文，或者菜单汉化了但编译器报错是乱码。这里要先厘清一个事实：Dev-C++ 本身是一个 IDE 外壳，它的中文支持分两层——界面语言和编译器输出语言。界面语言靠语言包切换，编译器输出语言取决于你用的是哪个编译器以及它的 locale 设置。常见的 Dev-C++ 发行版有两类：一类是原版 Bloodshed Dev-C++ 的衍生版，比如 Orwell Dev-C++，更新到 5.11 后基本停更；另一类是 Embarcadero 收购后重新维护的 Dev-C++ 6.x 版本，内置 TDM-GCC 编译器，对中文支持更好。如果你拿到的安装包解压后只有一个 exe，没有编译器目录，那它大概率是「裸 IDE」，需要你自己挂 MinGW 或 TDM-GCC。
选型建议很直接：Windows 10/11 上用 Dev-C++ 6.3 配合 TDM-GCC 9.2 或 MinGW-w64 8.1，不要用太老的 4.9.9.2 版本，那个版本对 C++11 以上标准支持残缺，写个 auto 就报错。如果你只是写 C 语言作业，TDM-GCC 9.2 完全够用；如果要写 C++17 的代码，建议直接换 VS Code 加 MinGW-w64，Dev-C++ 的编辑器对现代 C++ 语法高亮和补全支持有限。
2.2 安装后必须改的四个配置项
装完 Dev-C++ 第一件事不是写 hello world，而是把下面四个地方改掉，否则后面全是玄学问题。
第一个是编译器配置。打开「工具」→「编译选项」→「编译器」，勾选「编译时加入以下命令」，填入：
-std=c++17 -Wall -Wextra -fexec-charset=GBK这里-std=c++17指定语言标准，-Wall -Wextra打开常用警告，-fexec-charset=GBK是关键——Windows 控制台默认用 GBK 编码，不加这个，你的中文输出在控制台就是乱码。如果你写的是纯 C 代码，把c++17换成c11即可。
第二个是调试信息。在「编译选项」→「代码生成/优化」→「连接器」里，把「产生调试信息」设为 Yes。很多人反映 Dev-C++ 调试时断点不生效，八成是因为这个选项没开，编译出来的 exe 不带调试符号，gdb 根本挂不上去。
第三个是默认文件编码。在「工具」→「编辑器选项」→「显示」里，把「默认编码」改成 UTF-8。注意，这里改的是源文件保存编码，和上面编译器输出编码是两回事。源文件用 UTF-8，编译器输出用 GBK，这样既保证代码跨平台，又保证 Windows 控制台不乱码。
第四个是头文件搜索路径。如果你手动挂了 MinGW，需要在「目录」→「C++ 包含文件」里把编译器自带的 include 目录加进去，否则#include <stdio.h>会直接报找不到文件。
2.3 验证环境是否正常的三个命令
配置改完，新建一个源文件，贴入下面这段代码：
#include <stdio.h> #include <stdlib.h> int main() { // 测试中文输出和 C99 语法 int arr[] = {1, 2, 3}; for (int i = 0; i < 3; i++) { printf("数组元素 %d: %d\n", i, arr[i]); } printf("中文测试通过\n"); return 0; }按 F11 编译运行。如果控制台输出「数组元素 0: 1」到「数组元素 2: 3」以及「中文测试通过」，说明编译器、编码、C99 支持都正常。如果中文是乱码，回到 2.2 检查-fexec-charset参数；如果报for循环变量声明错误，说明标准没设对，检查-std参数。
再按 F5 进入调试模式，在printf那一行按 F4 设断点，看程序是否停住。如果断点变成空心圆圈，说明调试信息没开，回 2.2 第二条。最后在「工具」→「编译选项」里点「检查编译器配置」，Dev-C++ 会自检一遍路径和版本，有红字就按提示修。
3. 用 Dev-C++ 写第一个可调试项目：从新建到断点单步的完整链路
3.1 新建项目的正确姿势：控制台应用 vs 空项目
很多人打开 Dev-C++ 直接「文件」→「新建」→「源代码」，写完按 F11 也能跑，但这样建出来的文件没有项目概念，调试时没法管理多个源文件，也没法配置项目级编译参数。正确做法是「文件」→「新建」→「项目」，选择「Console Application」，语言选 C 或 C++，给项目起名并选一个空目录存放。Dev-C++ 会自动生成一个main.c或main.cpp模板，并创建一个.dev项目文件。
这里有个细节：如果你选的是「Console Application」并且勾了「C 项目」，模板里会自带system("pause")，这是为了在 Windows 上双击运行 exe 时窗口不闪退。但在调试模式下这行代码会卡住 gdb，建议调试时注释掉，或者改用getchar()。
空项目适合你已经有现成代码文件的情况，新建后手动把.c文件添加到项目里。注意不要用「打开」直接打开单个文件就开写，那样编译出来的 exe 是临时文件，调试符号路径会乱。
3.2 编译参数怎么设：三个必调项和两个可选优化
项目建好后，右键项目名→「项目属性」，这里可以设项目级编译参数，优先级高于全局设置。必调的三项：
第一，在「编译器」选项卡的「编译时加入以下命令」里，填入和全局类似的参数，但建议加上-g3：
-g3 -std=c17 -Wall -Wextra -fexec-charset=GBK-g3比默认的-g多包含宏定义信息，调试时能展开宏，看数组长度和结构体成员更方便。
第二，在「参数」选项卡里，设置「宿主应用程序」为gdb.exe的完整路径，通常在 Dev-C++ 安装目录的MinGW64\bin下。如果这里为空，F5 调试会提示找不到调试器。
第三，在「目录」选项卡里，确认「包含文件目录」和「库目录」指向正确的 MinGW 路径。如果你换了编译器但没改这里，会出现头文件版本和库版本不匹配的链接错误。
两个可选优化：如果你确定代码不需要调试，可以在「代码生成/优化」里把「优化级别」设为-O2，编译出的 exe 运行更快；如果项目文件多，勾选「编译时显示耗时」方便定位慢的编译单元。
3.3 断点、单步、监视变量的实操流程
调试是 Dev-C++ 最容易被低估的功能。按 F5 启动调试后，界面下方会出现调试工具栏。几个关键操作：
- F4：在当前行切换断点。断点行号旁会出现红色圆点。
- F7：单步进入函数内部。
- F8：单步跳过函数。
- F9：运行到光标所在行。
- Ctrl+F7：添加监视变量。
举个例子，下面这段代码用来演示调试流程：
#include <stdio.h> int factorial(int n) { if (n <= 1) return 1; return n * factorial(n - 1); // 在这一行设断点 } int main() { int result = factorial(5); printf("5! = %d\n", result); return 0; }在return n * factorial(n - 1);这行按 F4 设断点，按 F5 启动调试。程序会先停在断点处，此时在「监视」窗口输入n，可以看到当前 n 的值。按 F7 单步进入递归调用，观察 n 逐层递减。按 F8 则直接算出当前层结果。如果想看递归调用栈，打开「调试」→「调用栈」窗口，能看到 factorial 被调用的层级关系。
一个常见坑：如果断点行是空行或注释行，gdb 会把它移到下一个可执行语句，但 Dev-C++ 界面上断点还显示在原位置，容易误导。所以设断点尽量设在有实际语句的行上。
4. Dev-C++ 中文版避坑与排查：这五个问题几乎人人都会遇到
4.1 编译报错「undefined reference to `WinMain'」
现象：编译一个控制台程序，报错说找不到 WinMain，但你明明写了 main 函数。
原因：项目类型被设成了 Windows Application 而不是 Console Application。Windows Application 的入口是 WinMain，控制台程序入口是 main，链接器按错误入口去找自然找不到。
解决：右键项目→「项目属性」→「应用程序」选项卡，把「应用程序类型」改成「控制台应用程序」，重新编译即可。如果项目类型没错，检查 main 函数拼写，C 语言区分大小写，Main和main不是一回事。
4.2 调试时提示「无法启动 gdb.exe」
现象：按 F5 后弹窗说找不到 gdb 或无法启动调试器。
原因：Dev-C++ 安装时没有自带 gdb，或者「宿主应用程序」路径为空，或者路径里有中文或空格导致 gdb 启动失败。
解决：先确认 Dev-C++ 安装目录下MinGW64\bin\gdb.exe是否存在。如果没有，说明你装的是不带调试器的精简版，需要单独下载 MinGW-w64 并把 bin 目录加进去。如果有，在「工具」→「编译选项」→「程序」选项卡里，把 gdb 路径手动填成完整路径，比如D:\Dev-Cpp\MinGW64\bin\gdb.exe。路径里不要有中文，这是血泪经验，gdb 对中文路径支持极差。
4.3 中文输出乱码或源文件保存后中文变问号
现象：printf("你好")在控制台显示乱码，或者重新打开源文件发现中文变成???。
原因：源文件编码和编译器执行编码不一致。源文件存成 UTF-8，但编译器按 GBK 解析，或者反过来。
解决：两步走。第一步，在「工具」→「编辑器选项」→「显示」里把默认编码设为 UTF-8，然后重新保存源文件。第二步，在编译参数里加-fexec-charset=GBK，让编译器把字符串转成 GBK 输出到控制台。如果还乱码，在 main 函数开头加一行SetConsoleOutputCP(65001);并把编译参数改成-fexec-charset=UTF-8，强制控制台用 UTF-8 解码。两种方案选一种，不要混用。
4.4 断点不生效，程序直接跑完
现象：设了断点，按 F5 后程序直接运行结束，断点根本没停。
原因：编译时没生成调试信息，或者项目类型是 Release 模式，或者断点设在了不会被执行的代码分支上。
解决：检查「编译选项」→「代码生成/优化」→「连接器」里「产生调试信息」是否为 Yes。检查项目属性里是否误开了-O2优化，优化会重排代码导致断点偏移，调试时建议用-O0。如果断点在 if 分支里，确认条件确实为真，可以在断点前加一句printf确认代码走到了那里。
4.5 编译速度突然变慢或卡死
现象：之前编译很快，某次开始每次编译都要几十秒甚至卡死。
原因：项目目录里混入了大量无关文件，或者杀毒软件实时扫描拦截了 gcc 的临时文件读写，或者源文件里 include 了某个巨大的头文件。
解决：先看项目目录，把.o、.exe、备份文件清理掉，Dev-C++ 有时会把临时文件留在项目目录里导致重复扫描。然后把 Dev-C++ 安装目录和项目目录加入杀毒软件白名单。如果还慢，在「工具」→「编译选项」里关掉「编译时显示警告」和「编译时显示耗时」，减少界面刷新开销。最后检查代码里有没有#include <bits/stdc++.h>这种万能头，它会拖慢编译，换成具体头文件。
5. 把 Dev-C++ 用出花：三个进阶技巧和一套验证习惯
5.1 用自定义编译命令跑单元测试
Dev-C++ 支持在「工具」→「配置工具」里添加外部工具。我一般会加一个「运行测试」的菜单项，命令填cmd.exe，参数填/c "gcc -std=c17 -Wall test.c -o test.exe && test.exe"，工作目录设为项目目录。这样写完测试代码后，不用切到命令行，直接在 Dev-C++ 里点一下就能编译并运行测试。对于写 C 语言作业或者刷算法题的人来说，这个流程比每次按 F11 再手动开控制台快得多。
参数里的&&保证编译成功才运行，编译失败会停在错误信息上。如果你用 C++，把gcc换成g++，-std=c17换成-std=c++17。工作目录一定要设对，否则相对路径的文件读写会找不到。
5.2 用项目模板固定常用配置
每次新建项目都手动改编译参数很烦。Dev-C++ 允许你把当前项目另存为模板：先按 2.2 和 3.2 把参数配好，然后「文件」→「另存为模板」，起名比如「C17-Console-Debug」。下次新建项目时，在「新建项目」对话框里就能直接选这个模板，所有编译参数、调试设置、编码选项都会带过来。我一般会建两个模板，一个用于纯 C 作业，一个用于 C++ 小工具，区别只在-std参数和是否链接-lstdc++。
模板文件存在 Dev-C++ 安装目录的Templates文件夹下，换电脑时把这个文件夹拷过去就能复用。注意模板里不要包含具体的源文件内容，只保留项目结构和配置，否则每次新建都会带一堆示例代码。
5.3 一套五分钟自检清单
在把 Dev-C++ 交给学生或者自己开始一个新项目之前，我会花五分钟跑一遍下面这套检查。这套习惯帮我省掉了大量「为什么别人能跑我不能」的扯皮时间。
| 检查项 | 操作 | 通过标准 |
|---|---|---|
| 编译器版本 | 命令行运行gcc --version | 输出 TDM-GCC 9.2 或 MinGW-w64 8.1 |
| 编码配置 | 写一段中文 printf 并运行 | 控制台正常显示中文 |
| 调试器 | 设断点按 F5 | 程序停在断点行 |
| 标准支持 | 写auto x = 1;编译 | 无报错（C++）或改用int（C） |
| 项目类型 | 查看项目属性 | 控制台应用程序，非 Windows 应用程序 |
| 路径检查 | 查看安装目录和项目目录 | 全英文路径，无空格无中文 |
这套清单看起来简单，但 4.1 到 4.5 里的问题，九成都能靠它提前发现。我自己的习惯是每次换电脑或者重装系统后，先跑一遍这个表，确认环境没问题再开始写代码。Dev-C++ 这个工具虽然老，但把配置理顺之后，它的轻量和直接是很多现代 IDE 比不了的。希望帮到你。
本文还有配套的精品资源，点击获取
