总览:我们将完成什么?
- 安装必要软件:安装 C/C++ 编译器 和 Eclipse IDE for C/C++ Developers。
- 配置 Eclipse:告诉 Eclipse 在哪里找到我们的编译器。
- 创建第一个 C 项目:在 Eclipse 中创建一个 "Hello, World!" 项目。
- 编写、编译、运行代码:编写代码,并使用 Eclipse 的按钮一键完成编译和运行。
- 使用调试器:学习如何设置断点、单步执行代码,查看变量值,这是开发中最强大的功能之一。
第一步:安装必要的软件
在开始之前,请确保你的 Ubuntu 系统已经更新到最新状态。

更新软件包列表
打开终端(快捷键 Ctrl+Alt+T),运行以下命令:
sudo apt update
安装 GCC 编译器和 GDB 调试器
Eclipse 本身是一个开发环境,它需要一个“后端”工具来实际编译和调试你的代码,在 Linux 世界中,这个后端就是 GCC (GNU Compiler Collection) 和 GDB (GNU Debugger)。
sudo apt install build-essential gdb
build-essential是一个元数据包,它会自动安装gcc,g++,make等构建 C/C++ 程序所必需的核心工具。gdb是功能强大的命令行调试器,Eclipse 会调用它来进行图形化调试。
安装过程中,系统会提示你确认,输入 Y 并按回车即可。
安装 Eclipse IDE for C/C++ Developers
Eclipse 有很多版本,我们需要专门为 C/C++ 开发设计的版本。

- 访问 Eclipse 官方下载页面。
- 在 "Eclipse IDE for C/C++ Developers" 旁边点击 "Download"。
- 选择与你系统匹配的版本(通常是 64-bit)。
- 下载会得到一个
.tar.gz格式的压缩包,eclipse-cpp-2025-06-R-linux-gtk-x86_64.tar.gz。
解压并启动 Eclipse
- 打开你的“文件”管理器,进入“下载”文件夹。
- 右键点击下载的压缩包,选择“提取到此处”。
- 解压后,你会得到一个名为
eclipse的文件夹,你可以把它移动到你喜欢的位置,opt目录,或者就直接放在桌面上。 - 进入
eclipse文件夹,双击eclipse图标来启动它。 - 首次启动:Eclipse 会询问你选择一个工作空间,工作空间是存放你所有项目的地方,你可以使用默认路径,也可以点击 "Browse..." 选择一个你喜欢的位置,然后点击 "Launch"。
第二步:配置 Eclipse(重要!)
首次启动后,Eclipse 可能需要一些时间来索引,我们需要让它找到我们刚刚安装的 GCC/GDB 编译器。
-
点击顶部菜单栏的
Window->Preferences(在 macOS 上是Eclipse->Preferences)。 -
在弹出的窗口中,左侧导航栏找到并展开
C/C++->Build->Settings。 -
在右侧的
Builder settings标签页中,确保Use default build command是被勾选的,Eclipse 通常能自动检测到make命令,这已经足够了。
(图片来源网络,侵删) -
配置调试器,在左侧导航栏中,找到
C/C++->Debug->GDB。 -
在右侧的
GDB标签页中,确保GDB command的路径是正确的,你可以点击旁边的Search...按钮,Eclipse 应该能自动找到/usr/bin/gdb,如果找不到,手动输入这个路径。 -
点击右下角的
Apply and Close保存设置。
第三步:创建你的第一个 C 项目
所有准备工作都完成了,让我们创建一个项目。
-
在 Eclipse 主界面,点击顶部菜单栏的
File->New->C Project。 -
在弹出的窗口中:
Project name: 输入你的项目名称,hello_world。Project type: 选择Executable->Empty Project,这会创建一个最干净的项目结构。Toolchains: 确保GCC C Compiler被选中,Eclipse 会自动检测到它。
-
点击
Finish,Eclipse 会在你指定的工作空间下创建这个项目,并在左侧的C/C++ Projects视图中显示出来,目前项目是空的。
第四步:编写、编译和运行代码
创建源代码文件
- 在左侧的
C/C++ Projects视图中,右键点击你的项目名称hello_world。 - 选择
New->Source File。 - 在
Source file名称框中,输入main.c,然后点击Finish。
编写 "Hello, World!" 代码
一个空的 main.c 文件会被打开,将以下代码复制粘贴进去:
#include <stdio.h>
int main() {
printf("Hello, Ubuntu Eclipse C!\n");
return 0;
}
编译和运行
Eclipse 提供了非常方便的工具栏按钮。
- 编译:点击工具栏上的 锤子图标 (Build Project)。
- 如果一切正常,下方
Console视窗会显示编译信息,没有错误,如果你的代码有语法错误,这里会列出错误信息,你可以根据提示修改代码。
- 如果一切正常,下方
- 运行:点击工具栏上的 绿色三角形图标 (Run)。
- 程序会运行,并在
Console视窗中输出:Hello, Ubuntu Eclipse C!
- 程序会运行,并在
快捷键提示:
Ctrl + B: 快速编译项目。Ctrl + F11: 快速运行上次配置的程序。
恭喜!你已经成功在 Ubuntu 上使用 Eclipse 编译并运行了你的第一个 C 程序。
第五步:使用强大的调试器
调试是发现和修复代码逻辑错误的关键技能,让我们来调试 main.c。
-
设置断点:
- 在
main.c编辑器中,找到printf这一行。 - 在该行代码的左侧空白处,双击,会出现一个蓝色的圆点,这就是一个断点,程序运行到这一行时会暂停。
- 在
-
启动调试会话:
- 点击工具栏上看起来像一个小虫子的图标 (Debug)。
- 第一次调试时,Eclipse 会询问你切换到 "Debug" 透视图,点击
Switch。
-
调试界面介绍: 切换后,你会看到几个新的窗口:
- Debug 视窗:显示当前正在执行的线程和栈帧。
- Variables 视窗:显示当前作用域内所有变量的值。
- Breakpoints 视窗:列出所有已设置的断点。
- 编辑器中的蓝色高亮行:表示程序当前暂停的位置。
-
单步执行: 在顶部的调试工具栏上,你会看到几个非常有用的按钮:
- (F5) Step Into (单步进入): 如果当前行是一个函数调用,会进入该函数内部,否则,直接执行到下一行。
- (F6) Step Over (单步跳过): 执行当前行,无论是不是函数调用,如果是函数调用,它会完整地执行这个函数,而不会进入其内部,这是最常用的单步执行方式。
- (F7) Step Return (单步返回): 如果当前在一个函数内部,它会直接执行到该函数返回,然后回到调用它的地方。
- (F8) Resume (继续执行): 让程序继续运行,直到遇到下一个断点或程序结束。
-
观察变量:
- 在
Variables视窗中,你可以看到argc和argv的值。 - 尝试在
main.c中添加一个变量,int a = 10;,然后重新启动调试,你可以在Variables视窗中实时看到a的值。
- 在
-
结束调试: 当你调试完成后,点击工具栏上的 红色方块 (Terminate) 来停止程序,或者,点击工具栏上看起来像一个带红叉的小方块的图标 (Debug) 来退出调试模式,回到正常的编辑界面。
常见问题与解决方法
-
问题:编译时出现类似
g++: command not found的错误。- 解决:说明 GCC 没有安装成功,请返回第一步,重新运行
sudo apt install build-essential。
- 解决:说明 GCC 没有安装成功,请返回第一步,重新运行
-
问题:Eclipse 无法找到头文件(
stdio.h not found)。- 解决:这通常是索引问题,右键点击项目 ->
Index->Rebuild,如果还不行,检查Preferences->C/C++->Indexer中的设置是否正确。
- 解决:这通常是索引问题,右键点击项目 ->
-
问题:Eclipse 运行缓慢。
- 解决:Eclipse 基于 Java,对内存要求较高,可以尝试为它分配更多内存,找到
eclipse目录下的eclipse.ini文件,修改-Xms和-Xmx的值(-Xms512m -Xmx2048m)。
- 解决:Eclipse 基于 Java,对内存要求较高,可以尝试为它分配更多内存,找到
-
问题:终端里
ls或cd命令找不到路径。- 解决:确保你是在你的用户主目录下操作,或者使用
cd /path/to/your/eclipse/folder来进入正确的目录再运行./eclipse。
- 解决:确保你是在你的用户主目录下操作,或者使用
希望这份详细的指南能帮助你顺利地在 Ubuntu 上开始使用 Eclipse 进行 C 语言开发!祝你编码愉快!
