QT 项目 CMake 最佳实践

一个良好结构的 CMake 构建系统对 QT 项目至关重要。以下是现代 QT Widgets 应用的 CMake 配置。

项目结构

myapp/
├── CMakeLists.txt
├── src/
│   ├── main.cpp
│   ├── CMakeLists.txt
│   ├── models/
│   ├── views/
│   └── services/
└── tests/
    └── CMakeLists.txt

根目录 CMakeLists.txt

cmake_minimum_required(VERSION 3.20)
project(MyApp VERSION 1.0.0 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(Qt6 REQUIRED COMPONENTS Widgets Core Gui)

add_subdirectory(src)

关键实践

• 使用 target_link_libraries 而非 link_libraries
• 通过 target_compile_features 设置编译特性
• 使用 Qt6::Widgets 导入目标，而非单独的库
• 通过 enable_testing() 和 add_test() 启用测试

jacky

Full-Stack Developer with 10+ years of experience, specializing in QT C++ desktop application development and AI Agent systems.