1. 为什么选择CodeBlocksMinGW组合作为一个用了十几年各种IDE的老码农我可以负责任地说CodeBlocksMinGW绝对是Windows下C/C入门的最佳拍档。第一次接触这个组合还是读大学时教授推荐的轻量级解决方案没想到一用就是这么多年。它最大的优势就是安装包小带MinGW的版本不到200MB、启动快秒开不是梦、功能全代码补全、调试、项目管理一个不少。你可能听过Visual Studio这类商业IDE但对新手来说它们就像装满按钮的航天飞机驾驶舱。而CodeBlocks更像一辆可以随时改装的小跑车——该有的功能都有又不会让初学者晕头转向。我带的实习生里十个有九个第一次配置C环境都栽在VS的复杂配置上而用CodeBlocks的基本都能在半小时内跑通第一个程序。MinGWMinimalist GNU for Windows则是让Windows也能用上Linux那套GCC编译工具链的魔法钥匙。最新版的MinGW-w64支持C20标准性能不比商业编译器差。有次我测试同样的排序算法MinGW编译的执行速度居然比某商业编译器快15%当时就惊掉了下巴。2. 手把手下载安装包2.1 官网下载避坑指南打开浏览器输入官网地址www.codeblocks.org注意很多山寨网站会伪装成下载站。我有次不小心点进广告网站下到的安装包绑了一堆垃圾软件重装系统才清理干净。在Downloads页面你会看到两个关键选项Binary release直接可用的安装包Source code源码适合高手折腾点击Download the binary release后重点来了一定要选带MinGW的版本文件名中有mingw-setup字样。去年有个学员下了不带编译器的版本折腾三天都没配好环境最后发现是下载错了安装包。下载源建议优先选Sourceforge.net虽然速度可能慢点但最可靠。我实测过某些镜像站的版本会出现插件缺失的情况。如果下载速度实在慢可以试试用下载工具但要注意勾选只从原始地址下载避免下到被篡改的安装包。2.2 安装路径的学问运行安装程序时在Choose Install Location这一步很有讲究。我强烈建议不要用默认的C:\Program Files\原因有两个可能遇到权限问题特别是Win10/Win11路径含空格可能导致某些插件异常我的习惯是专门建个D:\DevTools目录然后把CodeBlocks装在这里。记得路径要全英文去年帮一个学生排查BUG最后发现是他用户名用了中文导致编译器找不到头文件。组件选择界面保持默认的Full installation就行。有个叫Contrib plugins的选项看起来很诱人但其实新手用不上装了反而可能拖慢启动速度。我曾经手贱全选过结果启动时间从2秒变成8秒...3. 首次启动的关键配置3.1 解决编译器警告第一次启动时90%的人都会看到这个烦人的黄色警告Couldnt find GNU GCC Compiler。别慌这就像新买的手机要插SIM卡一样正常。按以下步骤操作点击菜单栏Settings → Compiler左侧选Global compiler settings右侧选中GNU GCC Compiler点击Set as default设为默认切换到Toolchain executables标签在Compilers installation directory点Auto-detect这里有个坑如果自动检测失败我就遇到过三次需要手动指定MinGW路径。通常是在CodeBlocks安装目录下的MinGW文件夹比如D:\DevTools\CodeBlocks\MinGW。找不到的话可以按WinS搜索mingw32-g.exe它的所在目录就是正确路径。3.2 验证安装是否成功是时候祭出传统艺能Hello World了点击Create new project选择Console application一路Next项目名别用中文。在代码编辑区你会看到自动生成的代码#include iostream int main() { std::cout Hello world! std::endl; return 0; }按F9编译并运行如果弹出黑窗口显示Hello world!恭喜你但如果有错误最常见的是这两种情况g.exe not found说明编译器路径还是不对回到上一步检查Permission denied关掉杀毒软件再试特别是某数字卫士经常误杀4. 打造顺手的工作环境4.1 中文界面设置新版CodeBlocks-25.03自带中文支持比老版本方便多了。在Settings → Environment → View里勾选Internationalization语言选简体中文。不过说实话我建议初学者先用英文界面因为大部分技术文档都是英文术语错误信息也是英文的方便以后过渡到其他英文IDE有个学生跟我杠说中文看着亲切结果找工作笔试时连compiler是什么意思都要想半天...4.2 必备插件推荐虽然CodeBlocks开箱即用但这两个插件能让效率翻倍Code Completion代码补全安装时默认包含DoxyBlocks自动生成文档注释插件安装方法菜单栏Plugins → Manage plugins。注意别装太多插件我有次装了20多个插件启动速度直接从火箭变蜗牛。建议按需安装常用的就那几个。4.3 调试技巧入门按F8启动调试你会看到程序停在main()函数开头。几个实用技巧鼠标悬停变量上可查看当前值按F7单步执行在代码左侧点击设置断点Watch窗口可以监控变量变化去年带的一个实习生死活找不到数组越界错误我教他用调试器一步步跟踪五分钟就定位到问题。他说这比用printf打印高效多了早该学这个。5. 常见问题排雷指南5.1 编译错误大全error: cout was not declared解决方法检查是否写了#include我的翻车经历有次熬夜写代码把写成debug半小时才发现undefined reference to WinMain原因误选了Windows GUI项目正确做法创建项目时选Console application程序一闪而过在return 0;前加system(pause);或者直接在CodeBlocks里设置Settings → Environment → General Settings → 勾选Pause console programs after return5.2 项目迁移注意事项当你要把项目拷贝到其他电脑时切记拷贝整个项目文件夹不仅仅是.cpp文件检查.cbp项目文件中的路径是否相对路径如果用到第三方库记得一起打包我有次只发了源代码给客户结果他那边编译不过原来是我本地装了boost库但没告诉他。现在我都用CodeBlocks的Export project功能它能自动打包所有依赖文件。6. 进阶配置技巧6.1 自定义编译选项在Project → Build options里可以调优编译器设置开启-O2优化级别发布时用添加-stdc17支持新特性启用-Wall显示所有警告有个性能调优的经典案例去年做图像处理项目时开启-O3优化后程序运行速度提升了40%但代价是可执行文件大了30%。所以调试阶段建议用-O0发布再用-O2/-O3。6.2 多版本编译器管理你可以在Settings → Compiler里添加多个编译器比如MinGW-w64 32位版MinGW-w64 64位版Clang然后为不同项目指定不同编译器。我现在的做法是为每个项目创建独立的构建配置这样同一份代码可以快速测试在不同编译器下的表现。6.3 快捷键自定义推荐几个我改过的快捷键注释/取消注释改成CtrlQ原键太反人类格式化代码AltShiftF快速跳转CtrlG改键方法Settings → Editor → Keyboard shortcuts。改之前最好备份我有次手滑把全部快捷键清空了只能重装IDE...
从零到一：在Windows上搭建CodeBlocks-25.03与MinGW开发环境
发布时间：2026/7/25 16:12:00
1. 为什么选择CodeBlocksMinGW组合作为一个用了十几年各种IDE的老码农我可以负责任地说CodeBlocksMinGW绝对是Windows下C/C入门的最佳拍档。第一次接触这个组合还是读大学时教授推荐的轻量级解决方案没想到一用就是这么多年。它最大的优势就是安装包小带MinGW的版本不到200MB、启动快秒开不是梦、功能全代码补全、调试、项目管理一个不少。你可能听过Visual Studio这类商业IDE但对新手来说它们就像装满按钮的航天飞机驾驶舱。而CodeBlocks更像一辆可以随时改装的小跑车——该有的功能都有又不会让初学者晕头转向。我带的实习生里十个有九个第一次配置C环境都栽在VS的复杂配置上而用CodeBlocks的基本都能在半小时内跑通第一个程序。MinGWMinimalist GNU for Windows则是让Windows也能用上Linux那套GCC编译工具链的魔法钥匙。最新版的MinGW-w64支持C20标准性能不比商业编译器差。有次我测试同样的排序算法MinGW编译的执行速度居然比某商业编译器快15%当时就惊掉了下巴。2. 手把手下载安装包2.1 官网下载避坑指南打开浏览器输入官网地址www.codeblocks.org注意很多山寨网站会伪装成下载站。我有次不小心点进广告网站下到的安装包绑了一堆垃圾软件重装系统才清理干净。在Downloads页面你会看到两个关键选项Binary release直接可用的安装包Source code源码适合高手折腾点击Download the binary release后重点来了一定要选带MinGW的版本文件名中有mingw-setup字样。去年有个学员下了不带编译器的版本折腾三天都没配好环境最后发现是下载错了安装包。下载源建议优先选Sourceforge.net虽然速度可能慢点但最可靠。我实测过某些镜像站的版本会出现插件缺失的情况。如果下载速度实在慢可以试试用下载工具但要注意勾选只从原始地址下载避免下到被篡改的安装包。2.2 安装路径的学问运行安装程序时在Choose Install Location这一步很有讲究。我强烈建议不要用默认的C:\Program Files\原因有两个可能遇到权限问题特别是Win10/Win11路径含空格可能导致某些插件异常我的习惯是专门建个D:\DevTools目录然后把CodeBlocks装在这里。记得路径要全英文去年帮一个学生排查BUG最后发现是他用户名用了中文导致编译器找不到头文件。组件选择界面保持默认的Full installation就行。有个叫Contrib plugins的选项看起来很诱人但其实新手用不上装了反而可能拖慢启动速度。我曾经手贱全选过结果启动时间从2秒变成8秒...3. 首次启动的关键配置3.1 解决编译器警告第一次启动时90%的人都会看到这个烦人的黄色警告Couldnt find GNU GCC Compiler。别慌这就像新买的手机要插SIM卡一样正常。按以下步骤操作点击菜单栏Settings → Compiler左侧选Global compiler settings右侧选中GNU GCC Compiler点击Set as default设为默认切换到Toolchain executables标签在Compilers installation directory点Auto-detect这里有个坑如果自动检测失败我就遇到过三次需要手动指定MinGW路径。通常是在CodeBlocks安装目录下的MinGW文件夹比如D:\DevTools\CodeBlocks\MinGW。找不到的话可以按WinS搜索mingw32-g.exe它的所在目录就是正确路径。3.2 验证安装是否成功是时候祭出传统艺能Hello World了点击Create new project选择Console application一路Next项目名别用中文。在代码编辑区你会看到自动生成的代码#include iostream int main() { std::cout Hello world! std::endl; return 0; }按F9编译并运行如果弹出黑窗口显示Hello world!恭喜你但如果有错误最常见的是这两种情况g.exe not found说明编译器路径还是不对回到上一步检查Permission denied关掉杀毒软件再试特别是某数字卫士经常误杀4. 打造顺手的工作环境4.1 中文界面设置新版CodeBlocks-25.03自带中文支持比老版本方便多了。在Settings → Environment → View里勾选Internationalization语言选简体中文。不过说实话我建议初学者先用英文界面因为大部分技术文档都是英文术语错误信息也是英文的方便以后过渡到其他英文IDE有个学生跟我杠说中文看着亲切结果找工作笔试时连compiler是什么意思都要想半天...4.2 必备插件推荐虽然CodeBlocks开箱即用但这两个插件能让效率翻倍Code Completion代码补全安装时默认包含DoxyBlocks自动生成文档注释插件安装方法菜单栏Plugins → Manage plugins。注意别装太多插件我有次装了20多个插件启动速度直接从火箭变蜗牛。建议按需安装常用的就那几个。4.3 调试技巧入门按F8启动调试你会看到程序停在main()函数开头。几个实用技巧鼠标悬停变量上可查看当前值按F7单步执行在代码左侧点击设置断点Watch窗口可以监控变量变化去年带的一个实习生死活找不到数组越界错误我教他用调试器一步步跟踪五分钟就定位到问题。他说这比用printf打印高效多了早该学这个。5. 常见问题排雷指南5.1 编译错误大全error: cout was not declared解决方法检查是否写了#include我的翻车经历有次熬夜写代码把写成debug半小时才发现undefined reference to WinMain原因误选了Windows GUI项目正确做法创建项目时选Console application程序一闪而过在return 0;前加system(pause);或者直接在CodeBlocks里设置Settings → Environment → General Settings → 勾选Pause console programs after return5.2 项目迁移注意事项当你要把项目拷贝到其他电脑时切记拷贝整个项目文件夹不仅仅是.cpp文件检查.cbp项目文件中的路径是否相对路径如果用到第三方库记得一起打包我有次只发了源代码给客户结果他那边编译不过原来是我本地装了boost库但没告诉他。现在我都用CodeBlocks的Export project功能它能自动打包所有依赖文件。6. 进阶配置技巧6.1 自定义编译选项在Project → Build options里可以调优编译器设置开启-O2优化级别发布时用添加-stdc17支持新特性启用-Wall显示所有警告有个性能调优的经典案例去年做图像处理项目时开启-O3优化后程序运行速度提升了40%但代价是可执行文件大了30%。所以调试阶段建议用-O0发布再用-O2/-O3。6.2 多版本编译器管理你可以在Settings → Compiler里添加多个编译器比如MinGW-w64 32位版MinGW-w64 64位版Clang然后为不同项目指定不同编译器。我现在的做法是为每个项目创建独立的构建配置这样同一份代码可以快速测试在不同编译器下的表现。6.3 快捷键自定义推荐几个我改过的快捷键注释/取消注释改成CtrlQ原键太反人类格式化代码AltShiftF快速跳转CtrlG改键方法Settings → Editor → Keyboard shortcuts。改之前最好备份我有次手滑把全部快捷键清空了只能重装IDE...
