Code::Blocks 综合教程
目录
什么是 Code::Blocks?
Code::Blocks 是一个免费、开源、跨平台的 C/C++ 集成开发环境,它由 C++ 语言编写,并使用 wxWidgets 作为图形界面库。

主要特点:
- 免费开源:无需任何费用,可以自由使用和分发。
- 跨平台:支持 Windows、Linux 和 macOS。
- 高度可扩展:通过插件可以增强其功能,如代码自动补全、版本控制等。
- 轻量高效:相比于 Visual Studio 这样的大型 IDE,Code::Blocks 启动更快,占用资源更少,非常适合初学者和中小型项目。
- 灵活的编译器支持:可以与多种编译器(如 GCC, Clang, MSVC)无缝集成。
重要提示:Code::Blocks 本身不包含编译器,你需要单独安装一个 C/C++ 编译器,并将其配置给 Code::Blocks 使用,最常见的选择是 MinGW(Minimalist GNU for Windows),它是一个 GCC 的 Windows 移植版本。
安装与环境配置
对于 Windows 用户,最简单的方式是下载一个自带编译器的“codeblocks-with-minw”版本。
步骤 1: 下载
- 访问 Code::Blocks 官方下载页面:http://www.codeblocks.org/downloads
- 在 "Download the binary release" 部分,找到 "Windows" 版本。
- 推荐下载:带有
mingw编译器的版本,codeblocks-20.03mingw-setup.exe,这会一步到位地安装好 IDE 和编译器,省去手动配置的麻烦。
步骤 2: 安装
- 运行下载的
.exe文件。 - 按照安装向导的提示进行操作。建议不要安装在系统盘(如 C:\Program Files),因为某些插件或路径配置可能会遇到权限问题,可以安装在
D:\Dev\CodeBlocks这样的目录下。 - 在安装过程中,可能会询问是否为所有用户安装,根据你的需要选择即可。
- 等待安装完成。
步骤 3: 验证安装
- 安装完成后,启动 Code::Blocks。
- 点击顶部菜单栏的
Build->Build and run(或者直接按F9键)。 - 如果一切正常,Code::Blocks 会弹出一个控制台窗口,显示 "Hello world!",然后按任意键关闭,这说明你的编译器已经正确配置并可以工作了。
如果你下载了不带编译器的版本,或者需要手动配置编译器:
- 单独下载 MinGW:从 MinGW-w64 官网 下载最新的安装程序(推荐
x86_64-posix-seh版本,即 64 位)。 - 安装 MinGW:同样,建议安装到非系统盘路径,如
D:\Dev\mingw64。 - 配置环境变量:将 MinGW 的
bin目录(D:\Dev\mingw64\bin)添加到系统的Path环境变量中,这样你才能在任何命令行中使用gcc。 - 在 Code::Blocks 中配置:
- 打开 Code::Blocks,点击
Settings->Compiler...。 - 在弹出的窗口中,确保
Selected compiler是GNU GCC Compiler。 - 切换到
Toolchain executables选项卡。 - Code::Blocks 会自动尝试检测路径,如果没有,请手动填入 MinGW 的
bin目录。 - 点击
OK保存,之后Build->Build and run就可以正常工作了。
- 打开 Code::Blocks,点击
创建你的第一个 C/C++ 程序
步骤 1: 创建新项目
- 启动 Code::Blocks。
- 在启动界面,点击
Create a new project(或者主菜单File->New->Project...)。 - 在弹出的向导中,选择
Console application(控制台应用程序),然后点击Go。 - 接着选择
C或C++项目,这里我们以C++为例,点击C++ project。 - 为你的项目命名(
HelloWorld),并选择一个存放位置,然后点击Next。 - 选择你之前安装的编译器(通常是
GNU GCC Compiler),点击Finish。
步骤 2: 熟悉项目结构
创建完成后,你会看到 Code::Blocks 的主界面分为几个部分:
- 左侧:
Management窗口,显示你的项目文件,默认会有一个main.cpp文件。 - 中间:代码编辑区,
main.cpp的内容已经自动生成好了。 - 下方:
Build log或Messages窗口,用于显示编译和运行时的信息。
你的 main.cpp 文件内容应该如下:
#include <iostream>
int main()
{
std::cout << "Hello world!" << std::endl;
return 0;
}
步骤 3: 编译、运行和构建
这三个是开发中最核心的操作:
- 编译:将你的源代码(
.cpp文件)转换成机器可以识别的目标文件(.o或.obj),在 Code::Blocks 中,通常通过Build菜单的Compile current file或Build来完成。 - 链接:将所有目标文件和所需的库文件链接成一个可执行文件(
.exe)。Build操作包含了编译和链接。 - 运行:执行生成的可执行文件。
最常用的操作:
- 构建并运行:点击工具栏上的绿色齿轮图标(或者按
F9键),这个操作会先尝试编译和链接你的项目,如果成功,会立即运行程序。 - 仅构建:点击工具栏上的锤子图标(或者按
F7键),如果代码有错误,它会告诉你哪里出了问题,但不会运行程序。
对于你的 HelloWorld 项目,直接按 F9,你会看到下方的 Build log 窗口显示编译过程,然后弹出一个黑色控制台窗口,输出 "Hello world!"。
核心功能详解
1. 工作区
工作区是 Code::Blocks 管理项目的核心,一个工作区可以包含多个项目。
- 新建工作区:
File->New->Workspace... - 添加项目到工作区:在
Management窗口的工作区节点上右键,选择Add files...。
2. 编辑器
Code::Blocks 的编辑器功能强大,支持:
- 语法高亮:让代码更易读。
- 代码折叠:可以折叠或展开代码块(如函数、循环)。
- 代码补全:输入部分代码后,按
Ctrl+Space可以提示可能的函数或变量。 - 代码导航:在代码上右键,可以选择
Go to definition或Find usages,方便追踪函数和变量的定义与使用。
3. 编译器设置
如果你想修改编译选项,例如开启 C++11/14/17/20 标准、添加头文件路径、链接库文件等:
- 点击
Settings->Compiler...。 - 在
Compiler settings选项卡中,你可以:Global compiler settings:全局设置,对所有项目生效。Linker settings:添加链接的库文件(.lib或.a)。Search directories:添加头文件(#include)的搜索路径和库文件的搜索路径。
Default compiler's settings:默认编译器设置。- 在
Other compiler options中,你可以添加编译器标志,-std=c++17来使用 C++17 标准。
- 在
4. 构建与运行
Build 菜单提供了更多精细的控制:
Build(F7):构建整个项目。Build and run(F9):构建并运行。Rebuild(Ctrl+F11):彻底重新构建所有文件,非常耗时,但能解决一些奇怪的编译问题。Clean:删除所有中间文件(.o,.exe等),保持项目目录整洁。Stop build(Ctrl+Break):停止当前的构建过程。
5. 调试器
调试是编程中不可或缺的技能,Code::Blocks 集成了 GDB 调试器。
调试流程:
- 设置断点:在代码编辑器左侧的灰色区域,点击你想让程序暂停执行的行号旁边,会出现一个红色的圆点,这就是断点。
- 启动调试:点击工具栏上的“小虫子”图标(或者按
F8键)。 - 程序执行:程序会正常运行,直到遇到第一个断点,然后暂停。
- 调试窗口:调试启动后,下方会出现几个新窗口:
- Watches:可以在这里添加你想监视的变量或表达式,实时查看它们的值。
- Call stack:显示当前函数的调用栈。
- Debugging windows:提供内存、寄存器等更高级的查看选项。
- 控制程序执行:在调试工具栏上,你会看到几个关键按钮:
- Continue (
F5):继续执行,直到遇到下一个断点或程序结束。 - Step into (
F7):进入当前函数内部,逐行执行。 - Step over (
F8):执行当前行,但不会进入函数内部(如果该行是函数调用)。 - Step out (
Shift+F8):跳出当前函数,继续执行。 - Next line (
Ctrl+F7):与 Step over 类似,但行为更直观。
- Continue (
常用快捷键
掌握快捷键能极大提升效率。
| 功能 | 快捷键 |
|---|---|
| 构建并运行 | F9 |
| 构建项目 | F7 |
| 编译当前文件 | Ctrl+F9 |
| 启动调试 | F8 |
| 继续执行 | F5 |
| 单步步入 | F7 |
| 单步跳过 | F8 |
| 跳出函数 | Shift+F8 |
| 新建文件 | Ctrl+N |
| 打开文件 | Ctrl+O |
| 保存文件 | Ctrl+S |
| 保存所有文件 | Ctrl+Shift+S |
| 撤销 | Ctrl+Z |
| 重做 | Ctrl+Y |
| 代码补全 | Ctrl+Space |
| 查找 | Ctrl+F |
| 替换 | Ctrl+H |
| 转到定义 | Ctrl+Click |
常见问题与解决方案
-
问题:编译时出现类似
g++.exe: command not found或'gcc' is not recognized as an internal or external command...的错误。- 原因:Code::Blocks 找不到编译器。
- 解决方案:
- 确保你安装了 MinGW 编译器。
- 在 Code::Blocks 中,进入
Settings->Compiler...->Toolchain executables,检查并正确填写 MinGW 的bin目录路径。 - 如果你配置了系统环境变量,重启电脑后再试。
-
问题:编译成功,但运行一闪而过,看不到结果。
- 原因:程序执行完毕后,控制台窗口立即关闭。
- 解决方案:
- 在
main函数的return 0;之前添加一行代码:system("pause");,需要包含<cstdlib>头文件。 - 更好的方法是:在运行程序时,不要直接双击
.exe文件,而是在命令行(CMD)中运行它,这样窗口就不会自动关闭。 - 在 Code::Blocks 中,可以设置:
Settings->Environment...->General settings-> 勾选Pause when console closes。
- 在
-
问题:如何添加第三方库?
- 解决方案:
- 将库的头文件(
.h或.hpp)复制到你的项目目录或一个固定目录。 - 将库的文件(
.lib,.a,.dll,.so)复制到你的项目目录或一个固定目录。 - 在 Code::Blocks 中,
Settings->Compiler...。 - 在
Linker settings选项卡中,点击Add,选择库文件(.lib或.a)。 - 在
Search directories选项卡中,添加头文件和库文件的搜索路径。
- 将库的头文件(
- 解决方案:
总结与进阶学习
Code::Blocks 是一个非常适合初学者入门 C/C++ 的 IDE,它界面简洁,配置灵活,且完全免费,通过本教程,你应该已经掌握了:
- 如何安装和配置 Code::Blocks。
- 如何创建、编译、运行一个简单的 C++ 项目。
- 如何使用核心功能,特别是调试器。
- 如何解决一些常见问题。
进阶学习建议:
- 探索插件:在
Tools->Plugin Manager中,你可以安装各种插件来增强功能,如Code-completion提供更智能的代码补全,AStyle用于代码格式化。 - 学习 CMake:对于复杂的项目,手动管理编译选项很麻烦,可以学习使用 CMake 这样的构建工具,它能为 Code::Blocks(以及其他 IDE)生成项目文件。
- 尝试其他 IDE:当你对 C++ 有了更深入的了解后,可以尝试其他更现代或功能更强大的 IDE,如 Visual Studio(Windows 平台王者)、CLion(跨平台,非常强大,但付费)、VS Code(轻量级,通过插件配置)等,比较它们的优劣,找到最适合自己的工具。
希望这份教程对你有帮助!祝你编程愉快!
