CMake构建Qt项目始终链接Release库，Debug构建失败求助

环境信息 #

• 操作系统：Windows 11
• 构建工具：CMake 3.31.5、Visual Studio 2022
• 自定义编译Qt：通过Git克隆源码编译，执行命令 configure.bat -opensource -prefix C:\Qt -static -debug-and-release ...，安装后C:\Qt\lib目录下存在Qt6core.lib（Release版）和Qt6cored.lib（Debug版）等静态库文件

问题描述 #

创建基于该静态Qt的最小测试项目，CMakeLists.txt中已指定Qt6_DIR并链接Qt6::Core，Release构建正常，但Debug构建失败：Visual Studio中Debug和Release配置均链接了Release版本的Qt库，编译时出现_ITERATOR_DEBUG_LEVEL、RuntimeLibrary不匹配的链接错误。手动指定Debug库仅适用于小型项目，不具备扩展性，询问是否遗漏配置或存在CMake/Qt bug。

可能的配置遗漏点及修复方案 #

1. 让CMake明确区分Debug/Release Qt组件 #

CMake通过Qt的配置文件识别不同构建类型的库，但静态编译场景下可能需要显式关联。修改CMakeLists.txt，用条件判断链接对应版本的Qt目标：

find_package(Qt6 REQUIRED COMPONENTS Core)

target_link_libraries(你的项目名称 PRIVATE
    $<$<CONFIG:Debug>:Qt6::Cored>
    $<$<CONFIG:Release>:Qt6::Core>
)

2. 检查Qt编译时的RuntimeLibrary配置 #

编译Qt时需确保Debug和Release版本使用匹配的CRT（C运行时库）：

• Debug版对应/MDd或/MTd
• Release版对应/MD或/MT

重新编译Qt时，需在configure命令中显式指定运行时库类型，比如用静态CRT：

configure.bat -opensource -prefix C:\Qt -static -debug-and-release -static-runtime ...

或分别指定Debug/Release的运行时：

configure.bat ... -debug-and-release -debug-runtime -release-runtime ...

3. 清除CMake缓存并重新生成项目 #

CMake缓存可能残留旧配置，导致无法正确识别Debug库：

• 删除项目的build目录（或根目录下的CMakeCache.txt）
• 重新执行CMake生成VS项目：

cmake -S . -B build -G "Visual Studio 17 2022" -A x64 -DQt6_DIR=C:\Qt\lib\cmake\Qt6

4. 统一CMake与Qt的RuntimeLibrary设置 #

确保CMake的运行时库配置和Qt编译时一致，比如静态CRT配置：

set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")

如果Qt用动态CRT编译，则改为：

set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>DLL")

5. 验证Qt的配置文件正确性 #

检查C:\Qt\lib\cmake\Qt6Core\Qt6CoreTargets.cmake，确认Qt6::Cored目标是否正确关联到Qt6cored.lib。如果该目标缺失或路径错误，说明Qt编译安装过程存在问题，需要重新编译Qt。

关于是否是CMake/Qt bug #

如果以上配置均正确但问题仍存在，可能是特定版本CMake与Qt的兼容性问题：

• 尝试降级CMake到3.28.x稳定版，或升级到最新稳定版
• 查看Qt源码的最新补丁，确认是否存在静态库Debug/Release区分的已知问题

内容的提问来源于stack exchange，提问作者Solo