CMake构建Windows可执行文件运行时依赖DLL缺失问题解决方案问询

1. 修复TARGET_RUNTIME_DLLS漏抓依赖的问题 #

CMake 3.14的$<TARGET_RUNTIME_DLLS>只识别CMake原生导入的目标——也就是用add_library创建的库，或者find_package返回的IMPORTED目标。如果Boost是手动指定链接路径加入的，肯定会被遗漏。

操作步骤： #

• 改用现代CMake方式导入Boost：

  # 启用Boost的现代导入目标（CMake 3.12+支持）
  set(Boost_USE_STATIC_LIBS OFF)
  set(Boost_USE_MULTITHREADED ON)
  find_package(Boost REQUIRED COMPONENTS filesystem unit_test_framework) # 替换为你实际使用的组件
  # 链接时直接使用导入目标，不要手动写库名
  target_link_libraries(mytests PRIVATE Boost::filesystem Boost::unit_test_framework)
  

• 修正POST_BUILD命令，用copy_if_different避免重复复制，同时确保路径正确展开：

  if(WIN32)
      add_custom_command(TARGET mytests POST_BUILD
          COMMAND ${CMAKE_COMMAND} -E copy_if_different
          $<TARGET_RUNTIME_DLLS:mytests>
          $<TARGET_FILE_DIR:mytests>
          COMMAND_EXPAND_LISTS
          COMMENT "Copying runtime DLLs to test directory..."
      )
  endif()
  

2. 配置运行时PATH，无需复制DLL #

不想复制文件的话，直接给程序运行时的PATH添加依赖目录即可。之前的VS_DEBUGGER配置无效，大概率是目标写错（你配置的是myapp但测试目标是mytests）或路径拼接有问题。

针对单元测试的正确配置： #

if(WIN32)
    # 收集所有依赖DLL的目录
    set(RUNTIME_PATHS "")
    # 获取Boost的DLL目录（通过导入目标的属性自动获取）
    get_target_property(BOOST_DLL_PATH Boost::filesystem IMPORTED_LOCATION_RELEASE)
    get_filename_component(BOOST_DLL_DIR ${BOOST_DLL_PATH} DIRECTORY)
    list(APPEND RUNTIME_PATHS ${BOOST_DLL_DIR})
    # 其他依赖的DLL目录按同样方法添加

    # 配置VS调试器的环境变量
    set_target_properties(mytests PROPERTIES
        VS_DEBUGGER_WORKING_DIRECTORY "$<TARGET_FILE_DIR:mytests>"
        VS_DEBUGGER_ENVIRONMENT "PATH=$<JOIN:${RUNTIME_PATHS},;>;%PATH%"
    )

    # 配置ctest运行测试时的环境变量
    set_tests_properties(mytests PROPERTIES
        ENVIRONMENT "PATH=$<JOIN:${RUNTIME_PATHS},;>;%PATH%"
    )
endif()

这样无论是在VS中调试，还是用ctest执行测试，系统都会自动找到依赖DLL，无需手动复制。

3. 静态链接所有依赖，彻底告别DLL问题 #

如果项目允许，直接静态链接所有依赖，生成的可执行文件就不会依赖外部DLL：

• 对于Boost，开启静态链接开关：

  set(Boost_USE_STATIC_LIBS ON)
  find_package(Boost REQUIRED COMPONENTS ...)
  

• 其他第三方库也选择静态版本链接即可。
  注意：静态链接会增大可执行文件体积，且需确认所有依赖的许可证允许静态分发。

4. 用CMake的install命令自动部署（适合发布版本） #

如果是制作发布版本，使用install命令可以自动将所有依赖DLL打包到安装目录：

if(WIN32)
    install(TARGETS mytests
        RUNTIME DESTINATION bin
        LIBRARY DESTINATION lib
        ARCHIVE DESTINATION lib
    )
    # 自动安装依赖的DLL（CMake 3.14+支持）
    install(IMPORTED_RUNTIME_ARTIFACTS mytests)
endif()

执行cmake --install . --config Release后，所有需要的DLL会自动复制到安装目录的bin文件夹中。

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