CMake将Qt的DLL复制到运行时输出目录的问题求助

我之前也踩过MSVC这个CMake路径的坑，给你几个实用的解决方案，亲测有效：

方法一：用生成器表达式直接获取目标文件目录（最推荐） #

MSVC下Debug/Release的目录差异属于配置相关路径，CMake的生成器表达式能在构建阶段动态解析这些路径，完全避开静态变量的局限性。

针对Qt项目，你可以结合Qt自带的工具函数和生成器表达式来自动复制DLL：

Qt6示例： #

# 找到Qt6核心组件
find_package(Qt6 REQUIRED COMPONENTS Core Widgets)

# 创建你的可执行目标
add_executable(MyQtApp main.cpp)
target_link_libraries(MyQtApp PRIVATE Qt6::Core Qt6::Widgets)

# 自动获取Qt运行时DLL（包括依赖的系统DLL）
qt6_get_runtime_dlls(MyQtApp
    DLLS Qt6::Core Qt6::Widgets
)

# 构建后自动复制DLL到可执行文件所在目录
add_custom_command(TARGET MyQtApp POST_BUILD
    COMMAND ${CMAKE_COMMAND} -E copy_if_different
        $<TARGET_RUNTIME_DLLS:MyQtApp>
        $<TARGET_FILE_DIR:MyQtApp>
    COMMAND_EXPAND_LISTS
)

Qt5示例： #

Qt5的函数略有不同，需要手动接收DLL路径变量：

find_package(Qt5 REQUIRED COMPONENTS Core Widgets)

add_executable(MyQtApp main.cpp)
target_link_libraries(MyQtApp PRIVATE Qt5::Core Qt5::Widgets)

# 获取Qt运行时DLL路径
qt5_get_installed_runtime_dlls(MyQtApp
    DLLS Qt5::Core Qt5::Widgets
    OUTPUT_VARIABLE QT_RUNTIME_DLLS
)

# 复制DLL到目标目录
add_custom_command(TARGET MyQtApp POST_BUILD
    COMMAND ${CMAKE_COMMAND} -E copy_if_different
        ${QT_RUNTIME_DLLS}
        $<TARGET_FILE_DIR:MyQtApp>
)

这里的$<TARGET_FILE_DIR:MyQtApp>就是关键——它会在构建时自动解析为当前配置（Debug/Release）下可执行文件的实际目录，完全不需要手动判断配置类型。

方法二：手动配置每个配置的输出目录 #

如果你想明确控制输出路径，可以针对Debug/Release分别设置全局变量，之后就能直接通过变量访问：

# 手动指定不同配置的可执行文件输出目录
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_DEBUG ${CMAKE_CURRENT_BINARY_DIR}/Debug)
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_RELEASE ${CMAKE_CURRENT_BINARY_DIR}/Release)

# 复制DLL时用配置相关变量
add_custom_command(TARGET MyQtApp POST_BUILD
    COMMAND ${CMAKE_COMMAND} -E copy_if_different
        ${QT_RUNTIME_DLLS}
        ${CMAKE_RUNTIME_OUTPUT_DIRECTORY_$<CONFIG>}
)

为什么你之前的方法失效？ #

你提到RUNTIME_OUTPUT_DIRECTORY为空，是因为MSVC默认不会设置这个全局变量——CMake对MSVC采用的是按配置分离输出的策略，实际控制路径的是CMAKE_RUNTIME_OUTPUT_DIRECTORY_<CONFIG>这类带后缀的变量（比如CMAKE_RUNTIME_OUTPUT_DIRECTORY_DEBUG），而普通的RUNTIME_OUTPUT_DIRECTORY只有在你手动统一设置所有配置的输出路径时才会有值。

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