从.pro到CMakeLists.txt：手把手教你将老旧Qt项目从QMake迁移到CMake（附完整脚本）

从QMake到CMake：现代Qt项目构建系统迁移实战指南

1. 为什么需要从QMake迁移到CMake？

对于长期使用Qt开发的团队来说，QMake曾经是构建Qt项目的默认选择。但随着项目规模扩大和构建需求复杂化，QMake的局限性逐渐显现：

• 功能局限：缺乏对现代C++标准的完整支持
• 生态整合困难：难以与Conan/vcpkg等现代包管理器集成
• 跨平台一致性差：不同平台需要特殊处理
• 可维护性低：复杂项目的.pro文件难以管理

CMake作为现代构建系统的代表，提供了：

• 更强大的脚本语言 • 更好的IDE支持（VS Code, CLion等） • 完善的第三方库集成 • 跨平台一致性 • 更活跃的社区生态

2. 迁移前的准备工作

2.1 环境配置

确保系统已安装：

• CMake 3.5+（推荐3.15+）
• Qt 5.15+（配置好CMAKE_PREFIX_PATH）
• 可选：Ninja构建工具

# 检查CMake版本 cmake --version # 设置Qt路径（示例） export CMAKE_PREFIX_PATH=~/Qt/5.15.2/gcc_64

2.2 项目分析工具

创建分析脚本analyze_pro.py提取.pro文件关键信息：

import re def analyze_pro(filepath): with open(filepath) as f: content = f.read() # 提取关键变量 variables = { 'SOURCES': re.findall(r'SOURCES\s*\+?=\s*([^\n]+)', content), 'HEADERS': re.findall(r'HEADERS\s*\+?=\s*([^\n]+)', content), 'QT': re.findall(r'QT\s*\+?=\s*([^\n]+)', content), 'DEFINES': re.findall(r'DEFINES\s*\+?=\s*([^\n]+)', content) } return variables

3. 核心迁移步骤详解

3.1 基础项目结构转换

典型QMake项目结构：

project/ ├── main.pro ├── src/ │ ├── src.pro │ ├── main.cpp │ └── ... └── libs/ ├── lib1.pro └── lib2.pro

转换为CMake结构：

project/ ├── CMakeLists.txt ├── src/ │ ├── CMakeLists.txt │ ├── main.cpp │ └── ... └── libs/ ├── lib1/ │ └── CMakeLists.txt └── lib2/ └── CMakeLists.txt

根CMakeLists.txt示例：

cmake_minimum_required(VERSION 3.15) project(MyProject VERSION 1.0 LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) find_package(Qt5 REQUIRED COMPONENTS Core Gui Widgets) add_subdirectory(src) add_subdirectory(libs/lib1) add_subdirectory(libs/lib2)

3.2 Qt模块映射表

3.3 源文件处理

QMake:

SOURCES = main.cpp \ widget.cpp HEADERS = widget.h FORMS = mainwindow.ui RESOURCES = resources.qrc

CMake等效:

set(SOURCES main.cpp widget.cpp ) set(HEADERS widget.h ) qt5_add_resources(RESOURCES resources.qrc) add_executable(MyApp ${SOURCES} ${HEADERS} ${RESOURCES})

3.4 平台特定代码处理

QMake平台判断：

win32 { SOURCES += windows.cpp } unix { SOURCES += unix.cpp }

CMake等效：

if(WIN32) list(APPEND SOURCES windows.cpp) elseif(UNIX) list(APPEND SOURCES unix.cpp) endif()

4. 高级迁移场景处理

4.1 第三方库集成

QMake方式：

unix:LIBS += -L/usr/local/lib -lcurl win32:LIBS += C:/libs/curl.lib

CMake现代方式：

find_package(CURL REQUIRED) target_link_libraries(MyApp PRIVATE CURL::libcurl)

4.2 条件编译处理

QMake条件编译：

CONFIG(debug, debug|release) { DEFINES += DEBUG_MODE }

CMake等效：

target_compile_definitions(MyApp PRIVATE $<$<CONFIG:Debug>:DEBUG_MODE> )

4.3 安装规则迁移

QMake安装规则：

target.path = $$[QT_INSTALL_BINS] INSTALLS += target

CMake安装规则：

install(TARGETS MyApp RUNTIME DESTINATION bin LIBRARY DESTINATION lib ARCHIVE DESTINATION lib )

5. 自动化迁移辅助工具

5.1 pro2cmake转换脚本

import re import sys def convert_pro_to_cmake(pro_file): with open(pro_file) as f: content = f.read() # 基础项目信息 project_name = re.search(r'TARGET\s*=\s*(\S+)', content) project_name = project_name.group(1) if project_name else "MyProject" # 源文件处理 sources = re.findall(r'SOURCES\s*\+?=\s*([^\n\\]+)', content) sources = [s.strip() for s in sources if s.strip()] # 生成CMake内容 cmake_content = f"""cmake_minimum_required(VERSION 3.5) project({project_name}) set(SOURCES {'\n '.join(sources)} ) add_executable({project_name} ${{SOURCES}}) """ return cmake_content

5.2 增量迁移策略

1. 并行构建：保持.pro文件，同时添加CMakeLists.txt
2. 模块化迁移：按子系统逐个迁移
3. CI验证：在CI中同时运行两种构建系统
4. 渐进替换：先迁移核心模块，再处理插件和工具

6. 常见问题解决方案

问题1：MOC文件生成失败

解决方案：

set(CMAKE_AUTOMOC ON) # 启用自动MOC set(CMAKE_AUTORCC ON) # 启用自动资源编译 set(CMAKE_AUTOUIC ON) # 启用自动UI编译

问题2：Qt插件加载失败

解决方案：

# 对于需要Qt插件的情况 get_target_property(Qt5Core_location Qt5::Core LOCATION) get_filename_component(QT_INSTALL_PREFIX "${Qt5Core_location}" DIRECTORY) set(PLUGIN_PATH "${QT_INSTALL_PREFIX}/plugins") set(ENV{QT_PLUGIN_PATH} "${PLUGIN_PATH}")

问题3：调试信息不完整

解决方案：

if(CMAKE_BUILD_TYPE STREQUAL "Debug") add_compile_options(-g3 -O0 -ggdb) add_definitions(-DQT_DEBUG) endif()

7. 迁移后的优化建议

1. 采用现代CMake实践：

   • 使用target_*命令替代全局设置
   • 明确PRIVATE/PUBLIC/INTERFACE依赖

2. 集成静态分析工具：

   find_program(CLANG_TIDY_EXE NAMES "clang-tidy") if(CLANG_TIDY_EXE) set(CMAKE_CXX_CLANG_TIDY ${CLANG_TIDY_EXE}) endif()

3. 启用单元测试框架：

   enable_testing() add_subdirectory(tests) # tests/CMakeLists.txt find_package(Qt5 REQUIRED COMPONENTS Test) add_executable(MyTests test1.cpp test2.cpp) target_link_libraries(MyTests PRIVATE Qt5::Test MyLibrary) add_test(NAME MyTests COMMAND MyTests)

4. 性能优化配置：

   if(CMAKE_BUILD_TYPE STREQUAL "Release") include(CheckIPOSupported) check_ipo_supported(RESULT ipo_supported) if(ipo_supported) set(CMAKE_INTERPROCEDURAL_OPTIMIZATION TRUE) endif() endif()

8. 完整迁移示例

假设有一个典型Qt Widgets项目，原始.pro文件如下：

TARGET = MyApp QT += widgets SOURCES = main.cpp \ mainwindow.cpp HEADERS = mainwindow.h FORMS = mainwindow.ui RESOURCES = resources.qrc

对应的CMakeLists.txt：

cmake_minimum_required(VERSION 3.15) project(MyApp LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) # Qt自动处理MOC/UIC/RCC set(CMAKE_AUTOMOC ON) set(CMAKE_AUTORCC ON) set(CMAKE_AUTOUIC ON) find_package(Qt5 REQUIRED COMPONENTS Widgets) set(SOURCES main.cpp mainwindow.cpp ) set(HEADERS mainwindow.h ) set(FORMS mainwindow.ui ) qt5_add_resources(RESOURCES resources.qrc ) add_executable(MyApp ${SOURCES} ${HEADERS} ${FORMS} ${RESOURCES} ) target_link_libraries(MyApp PRIVATE Qt5::Widgets) install(TARGETS MyApp DESTINATION bin)

9. 迁移后的构建流程对比

传统QMake流程：

qmake make -j8

现代CMake流程：

mkdir build && cd build cmake -DCMAKE_BUILD_TYPE=Release -G Ninja .. ninja

性能对比：

10. 进阶技巧与最佳实践

1. 模块化设计：

   # 在子目录中定义库 add_library(MyLibrary STATIC src1.cpp src2.cpp) target_include_directories(MyLibrary PUBLIC include) target_link_libraries(MyLibrary PUBLIC Qt5::Core) # 在主项目中使用 add_executable(MyApp main.cpp) target_link_libraries(MyApp PRIVATE MyLibrary)

2. 跨平台资源处理：

   if(APPLE) set(ICON_MODE MACOSX_BUNDLE_ICON_FILE) set(ICON_PATH ${CMAKE_CURRENT_SOURCE_DIR}/macos/AppIcon.icns) elseif(WIN32) set(ICON_MODE RC_ICONS) set(ICON_PATH ${CMAKE_CURRENT_SOURCE_DIR}/windows/AppIcon.ico) endif() if(ICON_MODE AND ICON_PATH) set_target_properties(MyApp PROPERTIES ${ICON_MODE} ${ICON_PATH} ) endif()

3. 现代依赖管理：

   # 使用vcpkg find_package(ZLIB REQUIRED) target_link_libraries(MyApp PRIVATE ZLIB::ZLIB) # 使用Conan include(${CMAKE_BINARY_DIR}/conanbuildinfo.cmake) conan_basic_setup(TARGETS) target_link_libraries(MyApp PRIVATE CONAN_PKG::fmt)

4. 性能分析集成：

   option(ENABLE_PROFILING "Enable profiling support" OFF) if(ENABLE_PROFILING) find_package(Profiler REQUIRED) target_compile_definitions(MyApp PRIVATE ENABLE_PROFILING) target_link_libraries(MyApp PRIVATE Profiler::Profiler) endif()

通过系统性地迁移到CMake，Qt项目可以获得更好的构建性能、更强大的功能支持以及更顺畅的现代开发工具链集成体验。虽然迁移过程需要投入一定精力，但从长期项目维护和扩展的角度来看，这种投资将带来显著的回报。