CodeBlocks 20.03新手安装汉化教程：半小时跑通第一个C++程序

说句实在话每次帮新生配置第一台C/C开发环境我都觉得CodeBlocks 20.03这个版本简直是给新手最好的礼物。最新一届用NOI Linux备赛的同学训练时很多也拿CodeBlocks当日常主力编辑器而在Windows上20.03这个版本自带MinGW编译器内置中文语言包下载一个安装包就能完成安装和汉化整个流程比以前折腾Dev-C、手动配VS Code要省心太多。这篇文章我就把CodeBlocks 20.03的下载、安装、汉化、第一个C程序、常见问题全部拆开讲一遍。目标是让你照着一步步操作半小时内看到一个运行成功的Hello World并且界面还是中文的。适读人群就是刚开始学C/C的同学、准备NOI但还在Windows上练习的新手以及被各种开发环境折腾到崩溃的非计算机专业学生。1. 为什么新手阶段我建议选CodeBlocks1.1 新手配置C开发环境的痛我太懂了很多教程一上来就让你装Visual Studio或者Visual Studio Code然后去官网找MinGW-w64、手工配置环境变量、再装插件一套操作下来人已经麻了。对于刚学C的人烦恼根本不在语言本身而在“我明明照着截图点为什么这破环境就是跑不起来”。CodeBlocks解决的恰恰是这个核心痛点它是一个集成开发环境IDE里面已经帮你把编辑器、编译器、调试器、构建工具全部打包好了。你不需要知道GCC是什么不需要手动配置PATH不需要在命令行里敲g只需要打开软件、新建文件、点一下编译运行就有了结果。这种傻瓜化的体验对新手建立自信太重要了。1.2 CodeBlocks、Visual Studio、VS Code、Dev-C该怎么选我直接用一张表说清楚几款常见工具在“新手开学C”场景下的差异工具上手难度自带编译器安装体积适合人群CodeBlocks 20.03低自带MinGW约200MB零基础新手、NOI练习、日常写算法题Visual Studio高自带MSVC几个GB起步做Windows桌面开发、工程级项目VS Code中高不自带需配置轻量已经是老手、愿意折腾配置的人Dev-C低自带很小虽然上手快但停止维护多年界面老旧讲真Dev-C和CodeBlocks看起来很像都是轻量级IDE但Dev-C已经很久没有像样的更新了对Win10/11的适配、中文显示、调试支持都不如CodeBlocks。而VS Code虽然漂亮但你不能要求一个刚学for循环的人先去搞懂tasks.json和launch.json。VS Code是神器但不是新手的“第一把兵器”。1.3 20.03版本有哪些值得说的变化CodeBlocks的版本号有自己的节奏20.03就是2020年3月发布的版本虽然数字看着不新但它是目前最稳定、官方还在维护的主线版本。这个版本比我早几年用的16.01处理了很多细节问题最直观的有三点内置中文语言包16.01等老版本想汉化需要去网上下载语言文件、手工丢到locale目录操作麻烦还容易下到乱七八糟的第三方资源。20.03直接在设置里选语言点一下就能切换成简体中文。对高分屏和Windows新版系统的兼容性更好界面不会糊成一团菜单渲染也正常不会出现我之前在Win10上用老版本那种字体发虚的情况。自带MinGW-w64编译器选对安装包之后编译器和IDE一次到位不需要再分开装。所以说这个版本对新手真的很好安装简单、汉化简单、跑第一个程序也简单。2. 下载前的准备工作选对安装包比会安装更重要2.1 官方下载渠道在哪里老手一般直接搜CodeBlocks download或者去SourceForge页面。SourceForge是CodeBlocks官方发布文件的平台页面虽然看起来有一堆广告按钮但下载区域其实很明确。我给新手的建议是优先去CodeBlocks官网的下载页面点Downloads里面会根据你的操作系统列出对应的二进制安装包。别跑到第三方软件下载站下那种站点经常捆绑全家桶而且很多给的不是最新稳定版。注意SourceForge页面有大量广告位点下载按钮的时候留意鼠标悬停的链接地址别点到广告或者带Sponsored标明的位置。认准文件名里包含codeblocks和20.03字样的链接。2.2 看懂安装包文件名带不带mingw是分水岭这是最容易踩坑的地方我要把它单独拿出来讲。官网下载页面会列出好几个文件常见的有filename-20.03-setup.exe (不带mingw)filename-20.03-setup-nonadmin.exefilename-20.03mingw-setup.exe (带mingw)filename-20.03mingw-setup-nonadmin.exefilename-20.03mingw-setup-user.exe这有什么区别简单说文件名里带mingw的安装包才自带GCC编译器。如果你下载的是不带mingw的那个版本安装完打开软件会发现编译器列表是空的新建项目后没法编译然后再到处找编译器来配折腾半天。新手直接认准文件名里含有mingw-setup字样的安装包别的都先不考虑。如果你用的是Windows 10/11 64位系统一般选文件名里带64bit或者说明里标注64-bit的那个如果拿不准选不带架构标识的通用版本也能跑。2.3 下载前再确认三件事下载之前我建议你花30秒确认一下系统是Windows 7以上即可Win10/Win11用户最省心基本没有额外依赖。磁盘剩余空间至少有500MB虽然安装包不大但编译器解压后要占一点空间。杀毒软件暂时别拦截安装包。CodeBlocks是开源软件但安装器里带编译器组件个别杀软会误报属于误判安装时先允许运行即可。这三件事缺一不可吗不一定但确认完能让你后面少很多“不知道哪一步错了”的困惑。3. 一步一步把CodeBlocks装到电脑上3.1 安装向导总共就几步不用慌安装包下载完以后双击运行。整个安装过程就是典型的Windows向导式操作点Next/下一步就行我挑几个环节重点说一下。许可证页面直接点I Agree同意继续。这个页面选不同意也无法继续。选择安装组件的页面一般默认全选。注意看有没有MinGW相关的选项或者子组件有的话保持勾选状态。有些安装包会在这里列出MinGW compiler suite、仿真器之类的内容新手别手贱取消全默认即可。选择安装路径的页面这是全流程最重要的一步。建议直接使用默认路径比如C:\Program Files\CodeBlocks或者自己改成一个纯英文路径比如D:\CodeBlocks。我强调一下为什么不能有中文路径虽然新版CodeBlocks对中文路径忍耐度提高了但C编译器工具链GCC那套东西对中文路径的支持一直不完美。一旦你的安装路径里有“中文”“软件”这种字眼后面编译时很容易跳出一些看不懂的路径报错。我见过不少同学把项目建在“桌面/新建文件夹”下面编译直接崩改到英文路径就好了。所以从一开始就用纯英文路径能帮你避开一堆玄学问题。整个安装过程一般两到三分钟进度条走完以后勾选Launch CodeBlocks启动CodeBlocks点Finish结束安装。3.2 首次启动的编译器自动检测安装完成后第一次打开软件会弹出一个“Autodetect”编译器自动检测的确认框。这个框的意思是CodeBlocks正在自动找你电脑上的GCC编译器通常在带mingw的安装包里它直接就能找到。我建议你等它检测完看到编译器列表里有“GNU GCC Compiler”这项并且路径指向你安装目录下的MinGW文件夹才算是安装成功。如果这个窗口不小心被关了后面还有补救办法这个问题我放到第6章详细讲。3.3 验证编译器是否被正确识别顺利的话进入IDE主界面菜单栏是英文的这很正常。先别急我们做一个小验证打开顶部菜单Settings设置→ Compiler编译器→ Global compiler settings全局编译器设置。在Selected compiler选中的编译器下拉框里如果显示的是“GNU GCC Compiler”并且下方的C compiler和C compiler对应的路径是类似“你安装目录\MinGW\bin\gcc.exe”的内容那说明编译器已经正常识别。看到这个你的安装就成功了一大半。接下来汉化才轮到今天的主角。4. 20.03版本汉化内置语言包点几下就能变中文4.1 先说你可能看到的过时教程如果你在搜索引擎里搜CodeBlocks汉化极大概率会看到一类老教程先下载一个“zh_CN”语言文件然后打开安装目录下的locale文件夹把文件丢进去再改配置文件等等。我明确告诉你这类教程针对的是16.01及更早的版本20.03完全不需要这么干。20.03版本里已经自带了多国语言包而且提供了图形化的切换入口。看到那种下载语言的教程直接关掉就行别浪费时间。4.2 三步汉化实操位置一个都不能错汉化的操作路径一定不要找错菜单我按顺序说一下第一步打开顶部菜单栏的Settings设置。 第二步在下拉菜单里选择Environment...环境...。 第三步在弹出的环境设置窗口里看左侧分类列表找到**View视图**这一项点击它。然后注意窗口右侧往下翻有一个区域叫Internationalization国际化里面有一个语言下拉框。默认显示的是“English”或者“Default”。点开下拉框找到Chinese (Simplified)也就是简体中文选中它。选完之后点击窗口右下角的OK按钮。这时候软件通常会提示你需要重启才能生效或者没提示的话你自己把CodeBlocks完全关闭再重新打开一次。注意这里说的是把CodeBlocks彻底退出不是关掉一个项目窗口。在任务栏托盘、以及可能残留的进程里都确认一下没有CodeBlocks在运行再重新打开否则你会发现语言没有变化。4.3 重启之后看到的界面是什么样的重新打开软件你会看到顶部菜单栏变成了文件、编辑、视图、搜索、项目、构建、调试、设置这类的。整个主界面的菜单、对话框、右键菜单绝大多数都已经变成中文。之前用英文界面看不懂的“Build and Run”也变成了“构建并运行”。新手在界面上找任何功能都会顺畅很多。有一点需要提前给你打预防针汉化包不是100%完整的一些比较深处的设置对话框、部分插件的界面、某些提示信息可能还是英文。这是语言包本身的客观情况不是安装错了放心用就行。4.4 汉化后另一个必改设置代码字体经验之谈汉化之后顺手把代码编辑器的字体设置一下。因为默认字体在中文和代码混排的时候看起来稍微别扭。路径是设置Settings→ 编辑器Editor→ 字体Font选项把字体调成“Consolas”或者“宋体”字号14左右同时勾选“Retain the current cursor position while saving”这类辅助项。这个设置不影响编译纯粹是个人习惯。我一般喜欢把字号调到14盯着看一晚上眼睛不累。你按自己喜好来就行。5. 跑通第一个C程序整套工具才算真正装好了5.1 新建一个控制台项目汉化完成后正式进入“写代码”环节。打开软件点顶部菜单文件File→ 新建New→ 项目Project在弹出的项目模板窗口里选择控制台应用程序Console application然后点“去”Go按钮。后续的向导会问几个问题我逐个说明语言选择选C确定。项目名称给项目起个名比如HelloWorld注意别用中文名。项目保存路径也必须是英文路径。编译器选择默认就是“GNU GCC Compiler”不用改。其他配置一路默认点完成。创建完成后左侧的“管理”面板里能看到这个项目里面有一个main.cpp文件。CodeBlocks已经帮你生成了最基本的框架代码里面包含一个main函数。5.2 编译运行Hello World双击打开main.cpp默认的main函数大致长这样#include iostream using namespace std; int main() { cout Hello world! endl; return 0; }中间那行cout的输出内容你可以改成任意想写的话比如“I love C”。然后重要的一步来了点击顶部菜单的构建Build→ 构建并运行Build and run或者直接按键盘上的F9快捷键。此时编译器会把这个源文件编译成可执行程序然后自动弹出一个黑色的控制台窗口窗口里显示你写的输出内容。看到“Hello world!”出现在屏幕上恭喜你你的CodeBlocks开发环境已经彻底打通了。这个控制台窗口通常在程序运行结束后会自动关闭如果你想让窗口停住以便看清楚输出可以在return 0;之前加一行system(pause);注意这行代码在NOI比赛环境中是不能用的但平时自己做练习用没问题。5.3 常用快捷键还没记住的赶紧存一下新手期我最推荐记住三个快捷键能明显提升写代码效率快捷键作用F9编译并运行当前项目CtrlF9只编译不运行CtrlShiftC注释/取消注释选中代码注释快捷键是我特别提醒的很多新手早期写代码都不敢删代码用CtrlShiftC把一段代码临时注释掉调试起来比删除再恢复要高效得多。6. 安装、汉化、运行中的常见问题排查实录6.1 编译器没有自动检测到怎么办场景装的是带mingw的安装包但首次启动时自动检测弹窗没有出现或者检测完发现编译器列表是空的、显示红色警告。先在软件顶部找路径设置Settings→ 编译器Compiler→ 全局编译器设置Global compiler settings进去看右下角或下方的“Toolchain executables”页签检查目录是否指向了安装路径下的MinGW\bin文件夹。如果发现目录不对或者看起来是空的手动点击“...”按钮重新选择到CodeBlocks安装目录里的MinGW文件夹然后点OK。一般这样设置后左侧的编译器状态就会恢复正常。我处理过的案例里八成是装成了不带mingw的版本剩余两成是路径被改动。也可以先检查一下安装目录里到底有没有MinGW文件夹。如果没有说明你下错安装包了老老实实重下带mingw的版本这是最快的解法。6.2 编译报错找不到g这个命令编译时提示“g: fatal error: no input files”或“g不是内部或外部命令”基本上可以确定编译器没配置好。展开看就是CodeBlocks没有找到编译器可执行文件。解决顺序是先检查“设置→编译器→全局编译器设置→选中的编译器”是否为GNU GCC Compiler再看“可执行工具链”页签里的编译器安装目录确认路径存在且包含bin目录。极少情况下重启CodeBlocks就能解决因为有时是安装后第一次启动的变量没加载全。6.3 用中文路径建项目编译失败或运行失败这个坑真的太高频了。现象是新建项目时路径里有中文或者项目名里有中文编译时报错信息奇奇怪怪大概率还带一句“cannot open output file”。解决方法就一个把整个CodeBlocks工作目录换成纯英文路径文件夹命名避免“新建文件夹”“项目”等中文所有源码文件名也改成英文。6.4 汉化之后界面没变化或者只汉化了一半这种情况通常是重启没重启彻底。大家经常只关闭了项目窗口但CodeBlocks还在后台运行重新打开自然还是英文或者语言加载不完整。正确操作是点击右上角的关闭按钮后按CtrlAltDelete打开任务管理器在进程列表里确认没有codeblocks.exe然后再重新打开软件。如果你选择语言之后弹出了询问重启的对话框直接点是让它自动重启效果最好。还有部分同学卡在找不到“Internationalization”选项。注意一定要先进入“设置→环境”然后在左侧找“视图”这一栏右侧才会出现“国际化”设置。这里哪怕是九键玩家也不能跳过确实在这个位置多翻一翻。6.5 Windows Defender拦截或者系统防火墙弹窗CodeBlocks首次编译运行程序时Windows防火墙可能会弹窗询问是否允许程序访问网络这是正常现象。一般点是/允许即可。如果杀毒软件直接把你下载的安装包删了可以暂时关闭实时防护后重新下载安装完成后再开启。6.6 20.03版本在NOI训练时的正确姿势顺带说一个和NOI相关的细节如果你平时在Windows上用CodeBlocks刷题建议在设置里把“构建并运行”的快捷键记忆熟练因为比赛机上的操作逻辑是类似的。另外NOI正式环境下一般禁用了调试器平时练习可以自己开调试功能研究代码但比赛时不要依赖调试工具要多练习肉眼查错和输出调试信息。最后再分享一个我自己带新人的习惯环境装好之后先写一个最简单的C程序然后故意把代码改出错看看报错信息长什么样再改回来。这样做一次你对“编译器报错”这事就没那么恐惧了。CodeBlocks作为新手第一套C/C开发环境最不怕的就是折腾越是敢乱点越能明白每个菜单是干什么的。从装好、汉化、跑通Hello World这一步开始你的C学习之路就算是正式铺好了。