张苏丽1. Ubuntu 24.04与CLion环境准备
最近在Ubuntu 24.04上折腾CLion配置C/C++开发环境，发现这个组合虽然强大，但新手容易在环境配置环节踩坑。作为从VS Code转战CLion的老码农，我来分享一套经过实战检验的配置方案。
首先需要明确的是，Ubuntu 24.04作为最新的LTS版本，其默认的GCC编译器已经更新到13.x版本，这对C++23标准的支持相当完善。而CLion作为JetBrains家的专业C/C++ IDE，其智能代码分析和CMake深度集成是核心竞争力。两者搭配可以打造非常舒适的开发体验，但需要特别注意以下几个基础组件：
-
GCC工具链：Ubuntu 24.04默认安装的是gcc-13和g++-13，可以通过
sudo apt install build-essential获取完整编译工具包。建议额外安装clang-16作为备用编译器，方便对比验证代码兼容性。 -
CMake：CLion的核心构建工具，Ubuntu仓库中的版本可能较旧，建议通过Kitware官方APT源安装最新版：
bash复制wget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc | sudo gpg --dearmor -o /usr/share/keyrings/kitware-archive-keyring.gpg echo "deb [signed-by=/usr/share/keyrings/kitware-archive-keyring.gpg] https://apt.kitware.com/ubuntu/ jammy main" | sudo tee /etc/apt/sources.list.d/kitware.list sudo apt update && sudo apt install cmake -
调试工具：除了gdb之外，建议安装lldb和valgrind：
bash复制sudo apt install lldb valgrind
重要提示：Ubuntu 24.04默认启用了Wayland显示协议，这可能导致CLion的窗口渲染异常。如果遇到界面卡顿或闪烁，可以通过编辑
/etc/gdm3/custom.conf，取消WaylandEnable=false的注释并重启解决。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. CLion安装与初始配置
从JetBrains官网下载CLion的Linux版本时，建议选择.tar.gz格式的独立包而非Snap版本，因为后者在文件系统访问权限上常有诡异问题。解压后直接运行bin目录下的clion.sh即可启动，首次运行时会提示安装JetBrains Runtime。
激活环节建议使用教育邮箱申请免费授权，或者购买正版授权（学生可享受折扣）。网上流传的破解方案不仅存在法律风险，还可能引入恶意代码导致项目文件损坏——我就曾因此损失过一周的工作量。
安装完成后需要重点配置以下几个核心设置：
2.1 工具链配置
在File > Settings > Build, Execution, Deployment > Toolchains中：
- 添加Ubuntu本地工具链
- 确保自动检测到CMake、GCC、GDB的路径
- 将C和C++编译器都指向gcc-13和g++-13（如果需要使用clang，需在此处单独配置）
2.2 CMake预设配置
CLion 2023.3开始支持CMake Presets，建议在项目根目录创建CMakePresets.json：
json复制{
"version": 3,
"configurePresets": [
{
"name": "linux-debug",
"displayName": "Linux Debug",
"generator": "Unix Makefiles",
"binaryDir": "${sourceDir}/build/debug",
"cacheVariables": {
"CMAKE_BUILD_TYPE": "Debug",
"CMAKE_C_COMPILER": "gcc-13",
"CMAKE_CXX_COMPILER": "g++-13"
}
}
]
}
2.3 中文编码问题解决方案
如果遇到中文输出乱码，需要同时调整三处配置：
- CLion的VM选项：在
Help > Edit Custom VM Options中添加：code复制-Dfile.encoding=UTF-8 - 项目CMakeLists.txt中添加：
cmake复制add_compile_options(-exec-charset=UTF-8 -input-charset=UTF-8) - 终端环境变量：在
Settings > Tools > Terminal的环境变量中添加：code复制LANG=en_US.UTF-8
3. C/C++项目创建与编译实战
3.1 新建CMake项目
创建新项目时选择"C++ Executable"，CLion会自动生成标准的CMake项目结构：
code复制project/
├── CMakeLists.txt
├── main.cpp
└── cmake-build-debug/
自动生成的CMakeLists.txt可能需要以下优化：
cmake复制cmake_minimum_required(VERSION 3.26)
project(MyProject)
set(CMAKE_CXX_STANDARD 23)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
# 启用所有警告并视警告为错误
add_compile_options(-Wall -Wextra -Wpedantic -Werror)
# 调试模式下启用地址消毒剂
if(CMAKE_BUILD_TYPE STREQUAL "Debug")
add_compile_options(-fsanitize=address,undefined)
add_link_options(-fsanitize=address,undefined)
endif()
add_executable(MyProject main.cpp)
3.2 多文件项目组织
当项目规模扩大时，推荐采用如下结构：
code复制src/
├── core/
│ ├── algorithm.cpp
│ └── algorithm.h
├── utils/
│ ├── fileio.cpp
│ └── fileio.h
└── main.cpp
对应的CMakeLists.txt需要调整为：
cmake复制file(GLOB_RECURSE SOURCES "src/*.cpp")
add_executable(MyProject ${SOURCES})
# 包含目录
target_include_directories(MyProject PRIVATE
${CMAKE_CURRENT_SOURCE_DIR}/src
)
经验之谈：虽然GLOB_RECURSE方便，但在大型项目中可能导致CMake无法检测到新增文件。更规范的做法是显式列出所有源文件，或者使用CONFIGURE_DEPENDS选项（需要CMake 3.12+）。
3.3 第三方库集成
以集成Boost为例，首先安装开发包：
bash复制sudo apt install libboost-all-dev
然后在CMakeLists.txt中添加：
cmake复制find_package(Boost 1.82 REQUIRED COMPONENTS filesystem system)
target_link_libraries(MyProject PRIVATE Boost::filesystem Boost::system)
CLion的自动补全可能需要额外配置：在Settings > Languages & Frameworks > C/C++ > Code Assistance中，添加Boost的头文件路径（通常是/usr/include/boost）。
4. 高级调试与性能优化技巧
4.1 内存问题诊断
利用AddressSanitizer检测内存错误，在CMake配置中添加：
cmake复制if(CMAKE_BUILD_TYPE STREQUAL "Debug")
add_compile_options(-fsanitize=address,undefined -fno-omit-frame-pointer)
add_link_options(-fsanitize=address,undefined)
endif()
当程序崩溃时，CLion会自动跳转到问题代码位置，并在调试控制台显示详细的错误报告，包括：
- 堆栈溢出
- 使用释放后的内存
- 内存泄漏
- 未定义行为
4.2 性能热点分析
集成perf工具进行性能分析：
- 安装perf：
bash复制sudo apt install linux-tools-generic - 在CLion中创建"Profile"运行配置：
- 选择"Perf"性能分析器
- 设置采样频率（通常1000Hz足够）
- 运行后会生成火焰图，直观显示CPU时间消耗
4.3 单元测试集成
推荐使用Google Test框架：
- 安装：
bash复制sudo apt install libgtest-dev - 在CMakeLists.txt中添加：
cmake复制enable_testing() find_package(GTest REQUIRED) add_executable(MyTests test/test.cpp) target_link_libraries(MyTests GTest::GTest GTest::Main) add_test(NAME MyTests COMMAND MyTests) - CLion会自动检测测试用例，提供专用的测试运行界面
5. 生产力提升技巧
5.1 代码模板定制
在Settings > Editor > Live Templates中创建常用代码片段。例如创建"class"模板：
code复制class $NAME$ {
public:
$NAME$($PARAMS$);
~$NAME$();
private:
$END$
};
5.2 远程开发配置
通过CLion的远程开发功能连接更强大的服务器：
- 在
Tools > Deployment > Configuration中添加SSH连接 - 配置映射关系，将本地项目同步到远程
- 在
Toolchains中添加远程工具链
5.3 插件推荐
- CodeGlance：右侧迷你代码地图
- Key Promoter X：快捷键学习助手
- TabNine：AI代码补全（比CLion内置的更智能）
- CMake Simple Highlighter：增强CMake语法高亮
对于嵌入式开发，可以添加PlatformIO插件支持ESP32等开发板，但需要注意其与原生CMake项目的兼容性问题。我在使用中发现，对于复杂的嵌入式项目，还是建议保持纯CMake配置。
最后分享一个实用技巧：当CLion的索引卡住时，可以删除~/.cache/JetBrains/CLion2023.3/caches目录下的内容，然后重启IDE。这比直接Invalidate Caches更温和，不会丢失所有设置。