如何将Qt调试库关联到自定义ToolDebug配置目标？

核心思路 #

CMake默认仅识别Debug/Release等标准配置，自定义的ToolDebug配置需要明确告知CMake它属于调试类配置，让Qt的导入目标自动关联调试库，无需手动指定库路径。

具体步骤 #

1. 添加并配置ToolDebug自定义配置
   在CMakeLists.txt开头加入以下代码，定义ToolDebug配置并将其映射到Debug类型：

# 将ToolDebug添加到可用构建配置列表
set(CMAKE_CONFIGURATION_TYPES "${CMAKE_CONFIGURATION_TYPES};ToolDebug" CACHE STRING "Available build configurations" FORCE)

# 继承Debug配置的编译/链接参数（以MSVC为例，其他编译器可对应调整）
set(CMAKE_CXX_FLAGS_TOOLDEBUG "${CMAKE_CXX_FLAGS_DEBUG}")
set(CMAKE_C_FLAGS_TOOLDEBUG "${CMAKE_C_FLAGS_DEBUG}")
set(CMAKE_EXE_LINKER_FLAGS_TOOLDEBUG "${CMAKE_EXE_LINKER_FLAGS_DEBUG}")
set(CMAKE_SHARED_LINKER_FLAGS_TOOLDEBUG "${CMAKE_SHARED_LINKER_FLAGS_DEBUG}")

# 关键配置：将ToolDebug映射到Debug，让Qt导入目标自动使用调试库
set(CMAKE_MAP_IMPORTED_CONFIG_TOOLDEBUG "Debug")

2. 常规导入Qt并链接目标
   无需手动指定库路径，按标准流程使用find_package和target_link_libraries即可：

find_package(Qt6 REQUIRED COMPONENTS Core Widgets Gui OpenGL)

target_link_libraries(TableEditor PRIVATE
    Qt6::Core
    Qt6::Widgets
    Qt6::Gui
    Qt6::OpenGL
)

原手动方式的问题原因 #

手动指定库路径时，CMake不会自动过滤其他配置的依赖；同时默认情况下ToolDebug配置会匹配Qt的Release导入库，最终导致Debug和Release版本的库被同时链接。通过配置映射，CMake会让ToolDebug完全复用Debug类型的导入库规则，从根源避免重复链接问题。

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