下面我将为你提供一个超详细、从零开始的 CLion 配置 C 语言环境的教程,涵盖了从安装到编写、运行、调试的完整流程,我们将使用 CMake 作为构建系统,这是 CLion 推荐的最佳实践。

整体流程概览
- 准备工作: 安装必要的软件。
- 创建 CLion 项目: 使用 CMake 模板创建新项目。
- 编写 C 代码: 在项目中创建和编辑 C 源文件。
- 配置 CMake: 修改
CMakeLists.txt文件,让 CMake 知道如何编译你的 C 程序。 - 编译与运行: 使用 CLion 的工具栏或快捷键来构建和运行程序。
- 调试程序: 设置断点,使用调试器来分析代码执行流程。
- 常见问题与解决方案: 解决你可能遇到的常见错误。
第一步:准备工作(安装必要软件)
在开始之前,请确保你的电脑上已经安装了以下软件:
- CLion: JetBrains 官方 IDE,你可以从 JetBrains 官网 下载,新用户有 30 天免费试用期,学生和教师可以申请免费许可。
- C 编译器: 这是将你的 C 代码转换成可执行文件的核心工具。
- Windows: 推荐安装 MinGW-w64 或 Microsoft Visual Studio Build Tools。
- MinGW-w64 (推荐): 最简单的方式是使用一个集成环境,如 MSYS2,安装 MSYS2 后,通过其包管理器
pacman安装mingw-w64-x86_64-gcc工具链,CLion 通常能自动检测到它。 - VS Build Tools: 安装 Visual Studio Community,并在安装时选择“使用 C++ 的桌面开发”工作负载,这会包含 MSVC 编译器,CLion 也能很好地支持。
- MinGW-w64 (推荐): 最简单的方式是使用一个集成环境,如 MSYS2,安装 MSYS2 后,通过其包管理器
- macOS: 推荐使用 Xcode Command Line Tools,打开终端,运行以下命令安装:
xcode-select --install
- Linux (Ubuntu/Debian): 推荐使用 GCC,打开终端,运行以下命令安装:
sudo apt update sudo apt install build-essential
build-essential包包会自动安装gcc、g++和make等必要工具。
- Windows: 推荐安装 MinGW-w64 或 Microsoft Visual Studio Build Tools。
第二步:创建 CLion 项目
- 打开 CLion。
- 在欢迎界面,点击 "New Project" (新建项目)。
- 在左侧菜单中选择 "C Executable" (C 可执行文件),这会为你创建一个最基础的 C 项目结构。
- 在右侧配置项目:
- Name: 给你的项目起个名字,
hello_c。 - Location: 选择项目存放的路径。
- C++ standard: 对于纯 C 项目,保持默认的
C++11或更高版本即可,CMake 会处理兼容性,如果你非常确定,可以选择C11或C17,但这不是必须的。
- Name: 给你的项目起个名字,
- 点击 "Create" (创建)。
CLion 会为你生成一个基本的项目结构:
CMakeLists.txt: CMake 的配置文件,告诉 CMake 如何构建你的项目。main.c: 默认的 C 源文件,里面有一个main函数。
第三步:编写 C 代码
我们来修改 main.c 文件,写一个简单的 "Hello, World!" 程序,并增加一些稍微复杂一点的逻辑,方便后续演示调试功能。

打开 main.c替换为:
#include <stdio.h>
// 定义一个简单的函数
int add(int a, int b) {
return a + b;
}
int main() {
printf("Hello, CLion C Environment!\n");
int num1 = 10;
int num2 = 20;
int sum = add(num1, num2);
printf("The sum of %d and %d is %d.\n", num1, num2, sum);
return 0;
}
第四步:配置 CMake (CMakeLists.txt)
这是最关键的一步,CLion 的项目构建完全依赖于 CMakeLists.txt 文件,虽然 CLion 的模板已经为你生成了一个基础版本,但我们需要确保它明确指定了 C 语言标准。
打开 CMakeLists.txt 文件,内容应该类似这样:
cmake_minimum_required(VERSION 3.20) project(hello_c C) # 明确指定项目语言为 C set(CMAKE_C_STANDARD 11) # 设置 C 语言标准为 C11 set(CMAKE_C_STANDARD_REQUIRED ON) add_executable(hello_c main.c)
代码解释:
cmake_minimum_required(VERSION 3.20): 要求 CMake 的最低版本。project(hello_c C): 非常重要,这里声明了项目名为hello_c,并且指定了项目语言是 C,这会让 CMake 自动使用合适的编译器标志。set(CMAKE_C_STANDARD 11): 设置 C 语言标准为 C11,你也可以使用99(C99) 或17(C17)。set(CMAKE_C_STANDARD_REQUIRED ON): 表示必须使用指定的标准,如果编译器不支持,会报错。add_executable(hello_c main.c): 告诉 CMake 创建一个名为hello_c的可执行文件,它由main.c这个源文件编译而成。
如果你的项目有多个 .c 文件,只需要在这里添加进去,add_executable(hello_c main.c utils.c helper.c)。
第五步:编译与运行
配置完成后,CLion 通常会自动开始构建项目(你可以在右下角的工具窗口看到 "Build" 进度)。
-
手动构建:
- 点击顶部菜单栏的 "Build" -> "Build Project" (构建项目)。
- 或者使用快捷键
Ctrl + F9(Windows/Linux) 或Cmd + F9(macOS)。
-
运行程序:
- 点击右上角的绿色 "Run" 按钮(一个三角形图标)。
- 或者使用快捷键
Shift + F10(Windows/Linux) 或Ctrl + R(macOS)。
程序会在底部的 "Run" 窗口中执行,你应该能看到如下输出:
Hello, CLion C Environment!
The sum of 10 and 20 is 30.
配置工具链 (Toolchain):
CLion 没有自动检测到你的编译器,你需要手动配置工具链。
- 进入 "File" -> "Settings" (Windows/Linux) 或 "CLion" -> "Preferences" (macOS)。
- 导航到 "Build, Execution, Deployment" -> "Toolchains"。
- 点击左上角的 号,选择你的编译器类型,"MinGW" 或 "Visual Studio"。
- CLion 会尝试自动检测已安装的编译器,如果检测失败,你需要手动指定
C Compiler和C++ Compiler的路径(gcc.exe的完整路径)。 - 点击 "OK" 保存,CLion 会重新索引并使用新的工具链。
第六步:调试程序
调试是开发中至关重要的环节。
-
设置断点: 在代码行号的左侧空白处单击,会出现一个红色的圆点,这就是断点,我们想在
printf语句之前暂停,所以就在printf("Hello, ...");这一行设置断点。 -
启动调试器:
- 点击右上角的 "Debug" 按钮(一个臭虫图标)。
- 或者使用快捷键
Shift + F9(Windows/Linux) 或Ctrl + D(macOS)。
程序会启动并执行到断点处暂停,你会看到:
- Debug 窗口: 显示了各种调试信息。
- Variables 窗口: 显示了当前作用域内所有变量的值(
num1是 10,num2是 20)。 - Frames 窗口: 显示了函数调用栈。
- 使用调试控制按钮:
F8(Step Over): 执行当前行,如果当前行是函数调用,则进入该函数但不跳入其内部。F7(Step Into): 如果当前行是函数调用,则跳入该函数内部。Shift + F8(Step Out): 跳出当前函数,继续执行到函数返回后的位置。Alt + F9(Run to Cursor): 让程序执行到光标所在的位置。F9(Resume Program): 恢复程序运行,直到遇到下一个断点或程序结束。
你可以通过按 F8 逐行执行代码,并观察 Variables 窗口中 sum 的值如何从 add 函数中返回并更新。
第七步:常见问题与解决方案
-
问题:
CMake Error: The target named "hello_c" has linker language CXX, but the source file "main.c" has extension .c.- 原因:
CMakeLists.txt中没有明确指定项目语言为 C,或者add_executable混合了 C 和 C++ 文件。 - 解决: 确保你的
CMakeLists.txt中有project(your_project_name C)这一行。
- 原因:
-
问题: CLion 提示 "Toolchain is not configured" 或无法找到编译器。
- 原因: CLion 没有检测到你安装的 C 编译器。
- 解决: 按照 第五步 中的说明,手动配置你的工具链,并指定正确的编译器路径。
-
问题: 运行时弹出 "Process finished with exit code 139" (Linux/macOS) 或程序直接崩溃 (Windows)。
- 原因: 通常是 段错误 (Segmentation Fault),即程序试图访问它没有权限访问的内存区域,这是一个常见的 C 语言运行时错误。
- 解决: 这是调试的绝佳机会!使用 调试器,在你认为可能出错的地方(如指针操作、数组访问)设置断点,然后单步执行,观察变量和内存的变化,定位问题根源。
-
问题: 如何添加多个
.c文件?-
解决: 假设你有一个
utils.c和utils.h文件。-
将这两个文件复制到 CLion 项目的
cmake-build-debug(或你的构建目录) 同级目录下。 -
打开
CMakeLists.txt。 -
修改
add_executable行,将新文件加入进去:# 旧 # add_executable(hello_c main.c) # 新 add_executable(hello_c main.c utils.c)
-
在
main.c中,通过#include "utils.h"来使用头文件中的声明。
-
-
通过以上步骤,你就成功地在 CLion 中搭建了一个功能完备的 C 语言开发环境,CLion 的强大之处在于它的智能代码补全、重构、集成的调试器和 CMake 支持,这些都能极大地提升你的 C 语言开发效率。
你可以开始在这个环境中尽情地编写、编译、运行和调试你的 C 语言项目了!
