- 安装 Eclipse CDT 插件
- 配置编译器 和调试器
- 创建并运行你的第一个 C 项目
- 调试程序
- 常见问题与解决方案
准备工作:安装必要的工具
在安装 Eclipse 之前,我们需要确保系统上已经安装了 C 语言编译器 和 GDB 调试器,在 Ubuntu 上,最常用的是 GCC/G++ 和 GDB。

打开你的终端(可以通过 Ctrl + Alt + T 快捷键打开),然后输入以下命令:
sudo apt update sudo apt install build-essential gdb
build-essential是一个元数据包,它会自动安装 GCC (C 编译器), G++ (C++ 编译器), Make 等构建工具。gdb是 GNU 调试器,用于调试 C/C++ 程序。
安装完成后,你可以通过以下命令验证安装是否成功:
gcc --version gdb --version
如果能看到版本信息,说明安装成功。
第一步:下载并安装 Eclipse for C/C++ Developers
Eclipse 是一个平台,你需要下载专门用于 C/C++ 开发的版本。

-
访问 Eclipse 官网下载页面: https://www.eclipse.org/downloads/
-
选择 "Eclipse IDE for C/C++ Developers": 在页面中找到 "Eclipse IDE for C/C++ Developers" 的下载链接,根据你的系统选择 64-bit 版本,下载的是一个
.tar.gz格式的压缩包。 -
解压并安装: 在终端中,使用
cd命令进入你下载文件所在的目录(通常是~/Downloads),然后执行以下命令进行解压:# 将下面的 "eclipse-cpp-2025-06-R-linux-gtk-x86_64.tar.gz" 替换成你实际下载的文件名 tar -xvzf eclipse-cpp-*.tar.gz
解压后,你会得到一个名为
eclipse的文件夹。
(图片来源网络,侵删) -
启动 Eclipse: 进入
eclipse文件夹,运行eclipse可执行文件:cd eclipse ./eclipse
注意:首次运行时,系统可能会提示你“无法在此位置执行文件”,你需要右键点击 -> 属性 -> 权限 -> 勾选 “允许作为程序执行文件”。 或者,你也可以直接在文件管理器中进入
eclipse文件夹,双击eclipse图标来启动。 -
选择工作空间: 首次启动时,Eclipse 会让你选择一个“工作空间”(Workspace),这是一个用来存放你所有项目文件的文件夹,你可以使用默认路径,或者选择一个你自己的位置,然后点击 "Launch"。
第二步:配置编译器和调试器
虽然我们之前已经安装了 gcc 和 gdb,但为了让 Eclipse 能够找到它们,我们最好再进行一次配置。
-
打开 Eclipse,点击顶部菜单栏的
Window->Preferences...(在 macOS 上是Eclipse->Preferences...)。 -
在弹出的窗口中,展开左侧的
C/C++->Build->Settings。 -
在右侧的
Toolchains标签页下,点击右侧的Add...按钮。 -
在弹出的窗口中,选择
GCC(注意是GCC,不是Gnu Make Builder),然后点击OK。 -
返回到
Toolchains设置页面,你会看到一个名为GCC [Built-in]的条目,选中它,然后在右侧的Discovery选项卡中,点击Discover按钮,Eclipse 会自动扫描你系统上的gcc和gdb路径。 -
检查
Compiler path和Debugger path是否正确指向了/usr/bin/gcc和/usr/bin/gdb,通常自动扫描都是正确的,确认无误后,点击右下角的Apply and Close。
你的开发环境就配置好了。
第三步:创建并运行你的第一个 C 项目
-
创建新项目: 点击顶部菜单栏的
File->New->C Project。 -
配置项目:
- Project name: 输入你的项目名称,
HelloWorld。 - Project type: 选择
Executable。 - Toolchain: 确保
GCC被选中。 - 其他选项保持默认即可。
- Project name: 输入你的项目名称,
-
点击
Finish,Eclipse 会为你创建项目结构,并自动生成一个main.c文件。 -
编写代码: 在左侧的
Project Explorer视图中,展开你的HelloWorld项目,找到并双击main.c文件,编辑器会打开它,默认的代码可能是一个空的main函数,我们可以把它改成经典的 "Hello, World!":#include <stdio.h> int main(void) { printf("Hello, Ubuntu! Welcome to Eclipse C/C++!\n"); return 0; } -
编译和运行:
- 点击工具栏上的 锤子图标 (Build Project) 来编译你的代码,如果编译成功,下方的
Console视图会显示 "Build complete"。 - 编译成功后,点击工具栏上的 绿色三角形图标 (Run) 来运行程序。
- 首次运行时,会让你选择一个配置,选择
C/C++ Application,然后选择你的项目可执行文件(通常在HelloWorld/Debug/HelloWorld),点击Run。
程序会在下方的
Console视图中输出:Hello, Ubuntu! Welcome to Eclipse C/C++! - 点击工具栏上的 锤子图标 (Build Project) 来编译你的代码,如果编译成功,下方的
恭喜!你已经成功在 Ubuntu 上使用 Eclipse 运行了第一个 C 程序!
第四步:调试程序
调试是开发中非常重要的一环,Eclipse 的调试器非常强大。
-
设置断点: 在
main.c文件中,点击代码行号左侧的灰色区域,会出现一个蓝色的圆点,这就是一个断点,程序运行到这一行时会暂停。 -
启动调试: 点击工具栏上的 "Bug" 图标 (Debug) 来启动调试器。
-
切换到调试透视图: Eclipse 会询问你是否要切换到 "Debug" 透视图,选择
Switch。 -
使用调试工具: 程序会在你的断点处暂停,现在你会看到几个新的视图:
- Debug 视图:显示当前调用栈和线程状态,你可以看到
main函数被高亮。 - Variables 视图:显示当前作用域内的所有变量及其值。
i的值是未定义的。 - Editor:断点所在行会被高亮显示。
你可以使用调试工具栏上的按钮来控制程序执行:
- (F6) Step Over (单步跳过): 执行当前行,如果当前行是函数调用,则执行整个函数,然后停在下一行。
- (F5) Step Into (单步进入): 如果当前行是函数调用,则进入该函数内部。
- (F7) Step Return (单步返回): 执行完当前函数的剩余部分,然后返回到调用该函数的地方。
- (F8) Resume (继续): 让程序继续运行,直到遇到下一个断点或程序结束。
- 红色方块图标 (Terminate): 终止当前调试会话。
- Debug 视图:显示当前调用栈和线程状态,你可以看到
第五步:常见问题与解决方案
问题1:运行程序时提示 "Launch failed. Binary not found."
原因:Eclipse 无法找到编译生成的可执行文件。 解决方案:
- 确保你已经成功编译了项目(点击了锤子图标)。
- 在
Project Explorer中,确保你选择的是Debug配置来运行,有时项目会默认创建Debug和Release两种配置,检查你运行的是否是Debug下的可执行文件。 - 如果问题依旧,可以尝试
Project->Clean...,然后重新编译。
问题2:中文显示乱码
原因:Eclipse 控制台的字符编码与源文件编码不一致。 解决方案:
- 修改 Eclipse 的默认编码:
Window->Preferences->General->Workspace,将Text file encoding修改为Other: UTF-8。 - 修改控制台编码:在运行程序后,点击
Console视图右上角的小图标,选择Preferences,将Console font encoding也修改为UTF-8。
问题3:如何导入和管理多个项目?
你可以通过 File -> Import... -> General -> Existing Projects into Workspace 来导入已经存在的项目,所有项目都会在你的工作空间下管理,便于组织。
通过以上步骤,你已经搭建了一个功能完善的 C 语言开发环境,Eclipse CDT 提供了代码高亮、智能提示、代码补全、重构、项目管理等一系列强大功能,可以极大地提高你的开发效率。
你可以开始探索更多高级功能,比如使用 Makefile 进行项目管理、配置静态代码分析工具等,祝你编程愉快!
