目录
- 第一部分:环境准备
- 安装 Code::Blocks
- 验证安装
- 第二部分:创建并运行第一个 C 程序
- 创建新项目
- 编写代码
- 编译与运行
- 常见问题
- 第三部分:C 语言基础回顾
#include <stdio.h>int main()printfreturn 0;- 注释
- 第四部分:进阶操作
- 创建多文件项目
- 调试程序
- 第五部分:常见问题与解决方法
第一部分:环境准备
安装 Code::Blocks
最简单的方法是下载集成好的 MinGW 版本,MinGW 是一个在 Windows 上模拟类 Unix 环境的工具集,它包含了 GCC(GNU Compiler Collection),也就是我们用来编译 C 代码的编译器。

-
下载地址: Code::Blocks 官方下载页面
-
选择版本: 找到 "Download the release" 部分,下载带有
mingw或TDM-GCC字样的版本。codeblocks-XX.XXmingw-setup.exe,这个版本会自动为你安装好编译器,无需手动配置。 -
安装步骤:
- 运行下载的安装文件。
- 按照安装向导的提示进行操作,通常只需一路点击 "Next" 即可。
- 在选择组件的页面,确保
MinGW/GCC被勾选并安装,这是最关键的一步! - 选择安装路径(建议使用默认路径,方便后续查找)。
- 等待安装完成。
验证安装
安装完成后,打开 Code::Blocks,创建一个简单的 C 文件,然后尝试编译,如果成功,说明你的环境已经配置好了,如果出现 "compiler not found" 之类的错误,通常意味着 MinGW 没有正确安装或 Code::Blocks 没有找到它,最简单的解决方法是重新下载并安装带有 MinGW 的完整版。

第二部分:创建并运行第一个 C 程序
我们将创建一个经典的 "Hello, World!" 程序。
创建新项目
项目 是一个包含所有源代码文件、配置和编译信息的容器,创建项目是良好的编程习惯。
- 打开 Code::Blocks。
- 点击菜单栏的
File->New->Project...。 - 在弹出的窗口中,选择
Console application,然后点击Go。 - 接着选择
C language,然后点击Next >。 - 给你的项目起一个名字,
HelloWorld,并选择一个位置来保存它,点击Next >。 - 点击
Finish。
Code::Blocks 会自动为你创建一个 main.c 文件,并包含一些基本的代码模板。
编写代码
在左侧的 "Management" 面板中,双击 Sources 文件夹下的 main.c 文件,打开它。

你会看到类似下面的代码:
#include <stdio.h>
int main()
{
// TODO: Add your code here
printf("Hello world!\n");
return 0;
}
这就是我们的 C 程序,你可以直接运行它。
编译与运行
Code::Blocks 提供了非常方便的工具栏按钮:
-
构建: 这个按钮会编译你的代码,如果代码有语法错误,它会告诉你错误在哪里。
- 快捷键:
F9 - 图标: 一个带有锤子和扳手的齿轮 ⚙️
- 快捷键:
-
运行: 这个按钮会先构建(如果需要),然后运行你的程序。
- 快捷键:
F10 - 图标: 一个绿色的播放按钮 ▶️
- 快捷键:
操作步骤:
- 点击工具栏上的 运行 按钮(▶️)。
- Code::Blocks 底部的 "Build log" 窗口会显示编译信息,如果一切顺利,你会看到 "Build finished successfully"。
- 一个黑色的控制台窗口会弹出,显示:
Hello world! - 按任意键,窗口关闭。
恭喜!你已经成功用 C 语言和 Code::Blocks 编写并运行了你的第一个程序!
常见问题
-
问题: 点击运行后,程序窗口一闪而过,看不到结果。
-
原因: 程序运行速度太快,执行完毕后窗口立即关闭。
-
解决方法:
-
在
return 0;语句前添加一行代码:system("pause");。 -
你需要包含
<stdlib.h>头文件。 -
修改后的代码如下:
#include <stdio.h> #include <stdlib.h> // 添加这个头文件 int main() { printf("Hello world!\n"); system("pause"); // 添加这行 return 0; }
-
第三部分:C 语言基础回顾
让我们来逐行解释一下 main.c 里的代码。
#include <stdio.h>
#include是一个预处理指令,告诉编译器在编译之前,将指定文件的内容插入到当前文件中。<stdio.h>是一个头文件,stdio是 "Standard Input/Output"(标准输入输出)的缩写。- 这个文件包含了像
printf这样用于在屏幕上打印信息的函数的声明,没有它,printf函数就无法被识别。
int main()
main是主函数,每一个 C 程序都必须有一个main函数,它是程序执行的入口点,操作系统会从这里开始执行你的代码。int表示这个函数会返回一个整数值。return 0;表示程序成功执行完毕,没有发生错误。- 表示
main不接受任何参数。
printf("Hello world!\n");
printf是 "print formatted"(格式化打印)的缩写,它是一个函数,用于将文本输出到控制台。"Hello world!\n"是传递给printf的字符串。\n是一个转义字符,代表 "newline"(换行),它告诉printf在打印完 "Hello world!" 之后,将光标移动到下一行的开头。
return 0;
- 这行代码结束了
main函数的执行,并向操作系统返回值0,表示程序成功结束,这是 C 程序的标准做法。
注释
- 或 用于添加注释,注释是给人看的,编译器会忽略它们,用来解释代码的功能,提高可读性。
第四部分:进阶操作
创建多文件项目
当一个项目变大时,把所有代码都放在 main.c 里会变得混乱,我们可以将代码拆分到不同的文件中。
-
my_functions.h(头文件): 声明函数。// my_functions.h #ifndef MY_FUNCTIONS_H #define MY_FUNCTIONS_H // 声明一个函数 int add(int a, int b); #endif // MY_FUNCTIONS_H
-
my_functions.c(源文件): 实现函数。// my_functions.c #include "my_functions.h" // 包含我们自己的头文件 // 实现上面声明的函数 int add(int a, int b) { return a + b; } -
main.c(主程序): 调用函数。// main.c #include <stdio.h> #include "my_functions.h" // 包含我们自己创建的头文件 int main() { int result = add(5, 3); printf("The result is: %d\n", result); return 0; }
在 Code::Blocks 中,你可以通过 File -> New -> File... 来创建新的 .c 和 .h 文件,并将它们添加到项目中。
调试程序
调试是查找和修复程序逻辑错误(Bug)的关键过程。
- 设置断点: 在代码行号左侧的灰色区域点击,会出现一个红色的圆点,这就是断点,程序运行到这一行时会暂停。
- 开始调试: 点击工具栏上的 Debug 按钮(一个带有虫子的图标)或按
F8。 - 使用调试工具:
- Go/Continue (F9): 程序会运行到下一个断点或结束。
- Next Step (F7): 逐行执行代码,但不会进入函数内部。
- Step Into (Shift+F7): 如果当前行是一个函数调用,会进入该函数内部。
- Watch: 在 "Debug" 窗口中,你可以添加变量名来实时监控它们的值。
- Call Stack: 查看函数的调用层级关系。
第五部分:常见问题与解决方法
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
错误: cannot find -lgcc |
Code::Blocks 找不到 MinGW 的编译器。 | 确保安装了带 MinGW 的版本。 2. 进入 Settings -> Compiler -> Toolchain executables,检查路径是否正确。 3. 最简单的方法:重新安装 Code::Blocks (带 MinGW 版本)。 |
警告/错误: implicit declaration of function 'printf' |
忘记包含 #include <stdio.h>。 |
在文件开头添加 #include <stdio.h>。 |
| 程序窗口一闪而过 | 程序执行太快,立即退出。 | 在 main 函数末尾添加 system("pause"); 并包含 <stdlib.h>。 |
| 找不到自己创建的头文件 | 包含路径不正确。 | 使用 #include "my_header.h" (用引号而不是尖括号) 来包含本地文件。 |
希望这份详细的指南能帮助你顺利上手 C 语言和 Code::Blocks!祝你编程愉快!
