1. Ubuntu24下CLion搭建C/C开发环境全指南最近在Ubuntu 24.04 LTS上配置CLion进行C/C开发时发现不少细节问题会直接影响开发体验。作为JetBrains旗下专业的C/C IDECLion提供了代码分析、智能补全和强大的调试功能但在Linux环境下需要正确配置编译工具链才能发挥全部威力。本文将分享我在新系统上从零搭建环境的完整过程包括那些官方文档没写的实用技巧。注意Ubuntu 24.04采用了全新的软件包管理策略部分传统配置方法需要调整。特别是gcc/g的安装方式与之前版本有所不同。1.1 基础环境准备首先更新系统并安装必备组件sudo apt update sudo apt upgrade -y sudo apt install -y build-essential cmake gdb ninja-build关键组件说明build-essential包含gcc/g和基础开发库cmakeCLion默认使用的构建系统最低要求3.26版ninja-build比make更快的构建工具gdbGNU调试器建议安装12.1以上版本验证gcc版本gcc --version # 预期输出应包含类似gcc (Ubuntu 13.2.0-4ubuntu3) 13.2.0如果遇到E: Package build-essential has no installation candidate错误可能是软件源未更新。建议检查/etc/apt/sources.list文件确保包含deb http://archive.ubuntu.com/ubuntu noble main restricted1.2 CLion安装与优化推荐通过JetBrains Toolbox管理安装# 下载Toolbox wget https://download.jetbrains.com/toolbox/jetbrains-toolbox-2.3.3.16284.tar.gz tar -xzf jetbrains-toolbox-*.tar.gz cd jetbrains-toolbox-*/ ./jetbrains-toolbox安装后需要特别配置在Help Edit Custom VM Options中添加-Dsun.jnu.encodingUTF-8 -Dfile.encodingUTF-8禁用Wayland支持解决部分渲染问题echo -e \nexport CLION_DISABLE_WAYLAND1 ~/.profile2. 项目配置深度解析2.1 CMake工具链配置CLion通过CMake管理项目正确配置工具链是关键。新建项目时建议选择C17标准并在CMakeLists.txt中添加set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) set(CMAKE_EXPORT_COMPILE_COMMANDS ON) # 启用代码分析对于多文件项目推荐采用现代CMake结构project/ ├── CMakeLists.txt ├── include/ │ └── utils.h └── src/ ├── main.cpp └── utils.cpp对应的CMake配置示例cmake_minimum_required(VERSION 3.26) project(MyProject) add_executable(${PROJECT_NAME} src/main.cpp src/utils.cpp ) target_include_directories(${PROJECT_NAME} PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/include )2.2 调试配置技巧在.vscode/launch.json中添加以下配置可增强调试体验{ version: 0.2.0, configurations: [ { name: CLion Debug, type: cppdbg, request: launch, program: ${workspaceFolder}/build/${fileBasenameNoExtension}, args: [], stopAtEntry: false, cwd: ${workspaceFolder}, environment: [], externalConsole: false, MIMode: gdb, setupCommands: [ { description: Enable pretty-printing, text: -enable-pretty-printing, ignoreFailures: true } ] } ] }3. 常见问题解决方案3.1 中文乱码问题如果遇到控制台输出中文乱码按以下步骤解决检查系统locale配置locale # 应包含类似LANGzh_CN.UTF-8修改CLion启动脚本clion.shexport LANGzh_CN.UTF-8 export LC_ALLzh_CN.UTF-8在File Settings Editor File Encodings中全局编码UTF-8Project EncodingUTF-8勾选Transparent native-to-ascii conversion3.2 构建速度优化对于大型项目可通过以下方式提升构建速度使用Ninja替代Makecmake -DCMAKE_BUILD_TYPEDebug -DCMAKE_MAKE_PROGRAM/usr/bin/ninja -G Ninja ..启用并行编译在CMakeLists.txt中添加include(ProcessorCount) ProcessorCount(N) set(CMAKE_JOB_POOL_COMPILE compile_job_pool) set(CMAKE_JOB_POOLS compile_job_pool${N})使用ccache缓存sudo apt install ccache echo export PATH/usr/lib/ccache:$PATH ~/.bashrc4. 高级调试技巧4.1 内存问题排查配置AddressSanitizer检测内存错误set(CMAKE_CXX_FLAGS ${CMAKE_CXX_FLAGS} -fsanitizeaddress -fno-omit-frame-pointer) set(CMAKE_EXE_LINKER_FLAGS ${CMAKE_EXE_LINKER_FLAGS} -fsanitizeaddress)4.2 多线程调试使用gdb调试多线程程序时建议安装增强工具sudo apt install gdb-multiarch在CLion的Run/Debug Configurations中添加gdb命令set scheduler-locking on thread apply all bt5. 性能优化实践5.1 编译期优化根据不同需求选择合适的优化级别# 调试版本 set(CMAKE_CXX_FLAGS_DEBUG -O0 -g -Wall) # 发布版本 set(CMAKE_CXX_FLAGS_RELEASE -O3 -DNDEBUG -marchnative)5.2 代码分析配置启用clang-tidy进行静态分析安装工具sudo apt install clang-tidy在CLion中配置File Settings Editor Inspections启用Clang-Tidy检查建议配置参数-checks*,-clang-analyzer-*,-llvm*, -google*,-hicpp*,-modernize*, -cppcoreguidelines*,-readability*, -performance*,-portability*6. 第三方库集成6.1 vcpkg集成安装vcpkggit clone https://github.com/Microsoft/vcpkg.git ./vcpkg/bootstrap-vcpkg.sh在CLion中配置File Settings Build, Execution, Deployment CMake添加CMake选项-DCMAKE_TOOLCHAIN_FILE/path/to/vcpkg/scripts/buildsystems/vcpkg.cmake6.2 Conan包管理安装Conanpip install conan conan profile new default --detect创建conanfile.txt[requires] fmt/10.1.0 spdlog/1.12.0 [generators] cmake在CMakeLists.txt中添加include(${CMAKE_BINARY_DIR}/conanbuildinfo.cmake) conan_basic_setup(TARGETS)7. 跨平台开发配置7.1 Windows交叉编译安装MinGW工具链sudo apt install g-mingw-w64-x86-64CMake配置示例set(CMAKE_SYSTEM_NAME Windows) set(CMAKE_C_COMPILER x86_64-w64-mingw32-gcc) set(CMAKE_CXX_COMPILER x86_64-w64-mingw32-g)7.2 远程开发配置通过SSH连接远程服务器开发在Tools Deployment Configuration中添加SSH连接设置映射路径启用自动上传Tools Deployment Automatic Upload8. 实用插件推荐提升开发效率的必备插件CodeGlance右侧代码缩略图CMake Simple Highlighter增强CMake语法高亮Rainbow Brackets彩色配对括号TabNineAI代码补全SequenceDiagram自动生成调用时序图安装方法File Settings Plugins搜索插件名称安装重启CLion生效9. 性能监控与调优9.1 运行时分析使用perf工具进行性能分析sudo apt install linux-tools-common linux-tools-generic perf record -g ./your_program perf report9.2 内存分析安装Valgrindsudo apt install valgrindCLion配置创建新的Valgrind Memcheck运行配置设置检测参数--leak-checkfull --show-leak-kindsall --track-originsyes10. 持续集成配置10.1 GitHub Actions示例创建.github/workflows/build.ymlname: CMake Build on: [push, pull_request] jobs: build: runs-on: ubuntu-24.04 steps: - uses: actions/checkoutv4 - name: Install Dependencies run: | sudo apt update sudo apt install -y build-essential cmake - name: Configure run: cmake -B build -DCMAKE_BUILD_TYPERelease - name: Build run: cmake --build build --config Release --parallel 410.2 静态分析集成在CMake中集成SonarQubeinclude(${SONARQUBE_CMAKE}) sonarqube_properties( PROJECT_KEY my_project PROJECT_NAME My Project SOURCES src/ INCLUDE_DIRS include/ ) 
长河君 · 2026/8/12 12:13:54 · 阅读 1.2k Ubuntu24下CLion搭建C/C++开发环境全指南
1. Ubuntu24下CLion搭建C/C开发环境全指南最近在Ubuntu 24.04 LTS上配置CLion进行C/C开发时发现不少细节问题会直接影响开发体验。作为JetBrains旗下专业的C/C IDECLion提供了代码分析、智能补全和强大的调试功能但在Linux环境下需要正确配置编译工具链才能发挥全部威力。本文将分享我在新系统上从零搭建环境的完整过程包括那些官方文档没写的实用技巧。注意Ubuntu 24.04采用了全新的软件包管理策略部分传统配置方法需要调整。特别是gcc/g的安装方式与之前版本有所不同。1.1 基础环境准备首先更新系统并安装必备组件sudo apt update sudo apt upgrade -y sudo apt install -y build-essential cmake gdb ninja-build关键组件说明build-essential包含gcc/g和基础开发库cmakeCLion默认使用的构建系统最低要求3.26版ninja-build比make更快的构建工具gdbGNU调试器建议安装12.1以上版本验证gcc版本gcc --version # 预期输出应包含类似gcc (Ubuntu 13.2.0-4ubuntu3) 13.2.0如果遇到E: Package build-essential has no installation candidate错误可能是软件源未更新。建议检查/etc/apt/sources.list文件确保包含deb http://archive.ubuntu.com/ubuntu noble main restricted1.2 CLion安装与优化推荐通过JetBrains Toolbox管理安装# 下载Toolbox wget https://download.jetbrains.com/toolbox/jetbrains-toolbox-2.3.3.16284.tar.gz tar -xzf jetbrains-toolbox-*.tar.gz cd jetbrains-toolbox-*/ ./jetbrains-toolbox安装后需要特别配置在Help Edit Custom VM Options中添加-Dsun.jnu.encodingUTF-8 -Dfile.encodingUTF-8禁用Wayland支持解决部分渲染问题echo -e \nexport CLION_DISABLE_WAYLAND1 ~/.profile2. 项目配置深度解析2.1 CMake工具链配置CLion通过CMake管理项目正确配置工具链是关键。新建项目时建议选择C17标准并在CMakeLists.txt中添加set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) set(CMAKE_EXPORT_COMPILE_COMMANDS ON) # 启用代码分析对于多文件项目推荐采用现代CMake结构project/ ├── CMakeLists.txt ├── include/ │ └── utils.h └── src/ ├── main.cpp └── utils.cpp对应的CMake配置示例cmake_minimum_required(VERSION 3.26) project(MyProject) add_executable(${PROJECT_NAME} src/main.cpp src/utils.cpp ) target_include_directories(${PROJECT_NAME} PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/include )2.2 调试配置技巧在.vscode/launch.json中添加以下配置可增强调试体验{ version: 0.2.0, configurations: [ { name: CLion Debug, type: cppdbg, request: launch, program: ${workspaceFolder}/build/${fileBasenameNoExtension}, args: [], stopAtEntry: false, cwd: ${workspaceFolder}, environment: [], externalConsole: false, MIMode: gdb, setupCommands: [ { description: Enable pretty-printing, text: -enable-pretty-printing, ignoreFailures: true } ] } ] }3. 常见问题解决方案3.1 中文乱码问题如果遇到控制台输出中文乱码按以下步骤解决检查系统locale配置locale # 应包含类似LANGzh_CN.UTF-8修改CLion启动脚本clion.shexport LANGzh_CN.UTF-8 export LC_ALLzh_CN.UTF-8在File Settings Editor File Encodings中全局编码UTF-8Project EncodingUTF-8勾选Transparent native-to-ascii conversion3.2 构建速度优化对于大型项目可通过以下方式提升构建速度使用Ninja替代Makecmake -DCMAKE_BUILD_TYPEDebug -DCMAKE_MAKE_PROGRAM/usr/bin/ninja -G Ninja ..启用并行编译在CMakeLists.txt中添加include(ProcessorCount) ProcessorCount(N) set(CMAKE_JOB_POOL_COMPILE compile_job_pool) set(CMAKE_JOB_POOLS compile_job_pool${N})使用ccache缓存sudo apt install ccache echo export PATH/usr/lib/ccache:$PATH ~/.bashrc4. 高级调试技巧4.1 内存问题排查配置AddressSanitizer检测内存错误set(CMAKE_CXX_FLAGS ${CMAKE_CXX_FLAGS} -fsanitizeaddress -fno-omit-frame-pointer) set(CMAKE_EXE_LINKER_FLAGS ${CMAKE_EXE_LINKER_FLAGS} -fsanitizeaddress)4.2 多线程调试使用gdb调试多线程程序时建议安装增强工具sudo apt install gdb-multiarch在CLion的Run/Debug Configurations中添加gdb命令set scheduler-locking on thread apply all bt5. 性能优化实践5.1 编译期优化根据不同需求选择合适的优化级别# 调试版本 set(CMAKE_CXX_FLAGS_DEBUG -O0 -g -Wall) # 发布版本 set(CMAKE_CXX_FLAGS_RELEASE -O3 -DNDEBUG -marchnative)5.2 代码分析配置启用clang-tidy进行静态分析安装工具sudo apt install clang-tidy在CLion中配置File Settings Editor Inspections启用Clang-Tidy检查建议配置参数-checks*,-clang-analyzer-*,-llvm*, -google*,-hicpp*,-modernize*, -cppcoreguidelines*,-readability*, -performance*,-portability*6. 第三方库集成6.1 vcpkg集成安装vcpkggit clone https://github.com/Microsoft/vcpkg.git ./vcpkg/bootstrap-vcpkg.sh在CLion中配置File Settings Build, Execution, Deployment CMake添加CMake选项-DCMAKE_TOOLCHAIN_FILE/path/to/vcpkg/scripts/buildsystems/vcpkg.cmake6.2 Conan包管理安装Conanpip install conan conan profile new default --detect创建conanfile.txt[requires] fmt/10.1.0 spdlog/1.12.0 [generators] cmake在CMakeLists.txt中添加include(${CMAKE_BINARY_DIR}/conanbuildinfo.cmake) conan_basic_setup(TARGETS)7. 跨平台开发配置7.1 Windows交叉编译安装MinGW工具链sudo apt install g-mingw-w64-x86-64CMake配置示例set(CMAKE_SYSTEM_NAME Windows) set(CMAKE_C_COMPILER x86_64-w64-mingw32-gcc) set(CMAKE_CXX_COMPILER x86_64-w64-mingw32-g)7.2 远程开发配置通过SSH连接远程服务器开发在Tools Deployment Configuration中添加SSH连接设置映射路径启用自动上传Tools Deployment Automatic Upload8. 实用插件推荐提升开发效率的必备插件CodeGlance右侧代码缩略图CMake Simple Highlighter增强CMake语法高亮Rainbow Brackets彩色配对括号TabNineAI代码补全SequenceDiagram自动生成调用时序图安装方法File Settings Plugins搜索插件名称安装重启CLion生效9. 性能监控与调优9.1 运行时分析使用perf工具进行性能分析sudo apt install linux-tools-common linux-tools-generic perf record -g ./your_program perf report9.2 内存分析安装Valgrindsudo apt install valgrindCLion配置创建新的Valgrind Memcheck运行配置设置检测参数--leak-checkfull --show-leak-kindsall --track-originsyes10. 持续集成配置10.1 GitHub Actions示例创建.github/workflows/build.ymlname: CMake Build on: [push, pull_request] jobs: build: runs-on: ubuntu-24.04 steps: - uses: actions/checkoutv4 - name: Install Dependencies run: | sudo apt update sudo apt install -y build-essential cmake - name: Configure run: cmake -B build -DCMAKE_BUILD_TYPERelease - name: Build run: cmake --build build --config Release --parallel 410.2 静态分析集成在CMake中集成SonarQubeinclude(${SONARQUBE_CMAKE}) sonarqube_properties( PROJECT_KEY my_project PROJECT_NAME My Project SOURCES src/ INCLUDE_DIRS include/ )