从Qt Creator到CMake：在Ubuntu 20.04上配置Qt 5.15的现代C++开发环境
从Qt Creator到CMake：在Ubuntu 20.04上配置Qt 5.15的现代C++开发环境
在Linux生态中构建高效的C++开发环境，Qt Creator与CMake的组合正成为现代Qt开发者的首选方案。对于已经具备基础Linux/C++技能的开发者而言，如何将Qt 5.15、CMake和Ninja等工具无缝整合，形成流畅的开发工作流，是提升生产力的关键一步。本文将深入解析这套工具链的协同机制，帮助开发者在Ubuntu 20.04上搭建符合现代C++标准的开发环境。
1. 为什么选择CMake作为Qt 5.15的构建系统
Qt框架历史上长期依赖QMake作为默认构建工具，但随着项目复杂度提升和现代C++标准的演进，CMake逐渐展现出更强大的适应性。以下是CMake成为Qt官方推荐构建系统的核心原因：
- 跨平台一致性：CMake支持生成多种构建系统文件（Makefile、Ninja、VS项目等），同一套配置可在Windows/Linux/macOS间无缝切换
- 生态整合优势：超过80%的C++开源项目采用CMake，便于集成第三方库如Boost、OpenCV等
- 现代特性支持：完美兼容C++11/14/17标准，支持模块化构建和条件编译
- Qt官方转向：自Qt 6起，CMake已成为官方默认构建系统，Qt 5.15是最后一个同时支持QMake和CMake的LTS版本
# 检查系统CMake版本（推荐≥3.16） cmake --version # 若版本过低可使用apt升级 sudo apt install cmake提示：虽然QMake仍可使用，但新项目建议直接采用CMake，避免后续迁移成本
2. 安装Qt 5.15时的关键组件选择
通过Qt官方在线安装器安装时，组件选择直接影响后续开发体验。以下是针对现代C++开发的优化配置方案：
2.1 基础编译环境准备
在安装Qt前，需确保系统具备完整的编译工具链：
sudo apt update sudo apt install build-essential libgl1-mesa-dev ninja-build2.2 Qt安装器中的必选组件
| 组件分类 | 关键组件 | 作用说明 |
|---|---|---|
| Qt库 | Qt 5.15.2 Desktop GCC 64-bit | 主开发库 |
| Developer Tools | Qt Creator 10+ | 官方IDE |
| Developer Tools | CMake 3.16+ | 构建系统 |
| Developer Tools | Ninja | 并行构建工具 |
| Additional Libraries | Qt Charts/Qt Data Visualization | 按需选择 |
安装命令示例（使用国内镜像加速）：
./qt-unified-linux-x64-4.6.0-online.run --mirror https://mirrors.aliyun.com/qt3. 配置Qt Creator的CMake项目环境
Qt Creator作为Qt官方IDE，其CMake集成度直接影响开发效率。以下是优化配置的关键步骤：
3.1 工具链检测与配置
- 打开Qt Creator → Tools → Options → Kits
- 验证自动检测到的工具链：
- C++编译器（g++）
- CMake工具
- Ninja构建系统
- 创建新Kit（推荐）：
- 命名：Qt 5.15 CMake
- 选择Qt 5.15.2版本
- 指定CMake和Ninja路径
3.2 创建CMake项目实践
新建项目时选择"CMake Build System"，典型项目结构如下：
project_root/ ├── CMakeLists.txt ├── src/ │ ├── main.cpp │ └── ... └── build/ # 外部构建目录示例CMake配置（含Qt模块）：
cmake_minimum_required(VERSION 3.16) project(ModernQtApp LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) find_package(Qt5 REQUIRED COMPONENTS Core Widgets) add_executable(app src/main.cpp ) target_link_libraries(app Qt5::Core Qt5::Widgets )4. 现代C++开发工作流优化
4.1 构建系统协同机制
理解工具链中各组件的角色对高效开发至关重要：
- Qt Creator：提供代码编辑、UI设计、调试等IDE功能
- CMake：管理项目构建规则和依赖关系
- Ninja：执行实际构建任务，比Make更快
- GCC/Clang：完成源代码到二进制文件的转换
4.2 生产力提升技巧
- 并行编译：在CMake配置中启用Ninja多线程构建
set(CMAKE_BUILD_PARALLEL_LEVEL 8) - 单元测试集成：在CMake中配置Google Test
enable_testing() add_subdirectory(tests) - 静态分析支持：在Qt Creator中集成clang-tidy
sudo apt install clang-tidy
5. 常见问题与解决方案
5.1 构建环境问题排查
GL库缺失错误：
/usr/bin/ld: cannot find -lGL解决方案：
sudo apt install libgl1-mesa-devCMake找不到Qt： 确保在Kit配置中正确指定了Qt版本路径，或显式设置：
set(Qt5_DIR "/path/to/Qt/5.15.2/gcc_64/lib/cmake/Qt5")
5.2 性能优化配置
在大型项目中，这些配置可显著提升体验：
# 启用预编译头 target_precompile_headers(app PRIVATE <QtCore/QtCore> <QtWidgets/QtWidgets> ) # 启用Unity Build（减少编译单元） set(CMAKE_UNITY_BUILD ON)6. 从QMake迁移到CMake的实践策略
对于已有QMake项目，推荐采用渐进式迁移：
- 并行维护阶段：保持QMake配置同时添加CMakeLists.txt
- 模块化迁移：按子项目逐步转换.pro文件
- 自动化测试：确保构建结果一致
- 团队培训：统一CMake编写规范
迁移工具推荐：
# 使用官方转换工具（需安装qttools5-dev-tools） sudo apt install qttools5-dev-tools qmake -project qmake make cmake在实际项目迁移中，发现最大的挑战是处理Qt特有的宏和资源系统。通过创建共享的CMake函数库，可以封装这些特殊逻辑，保持构建脚本的整洁性。例如，将qrc资源处理封装为：
function(qt_add_resources target) qt5_add_resources(${target}_RCC ${ARGN}) target_sources(${target} PRIVATE ${${target}_RCC}) endfunction()