如何通过CMake配置Windows共享库安装，确保运行时可被找到

我编写了一个用于共享库的小型CMake项目：

add_library(MySharedTarget SHARED "public.h" "implementation.cpp")

target_include_directories(
    MySharedTarget 
    INTERFACE
    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}> # 构建阶段使用当前源码目录作为包含路径
    $<INSTALL_INTERFACE:include> # 安装后使用导出的include路径
)
# 将公共头文件复制到安装目录
install(FILES "public.h" DESTINATION include)

# 将.lib和.dll分别复制到lib和bin目录
install(
    TARGETS MySharedTarget 
    EXPORT MySharedTarget 
    ARCHIVE DESTINATION lib/$<CONFIG>
    RUNTIME DESTINATION bin/$<CONFIG>
)

# 生成供客户端使用的目标定义文件
install(EXPORT MySharedTarget 
  FILE MySharedTargetTargets.cmake
  DESTINATION cmake
)

include(CMakePackageConfigHelpers)

# 生成供find_package识别的配置文件
configure_package_config_file(
  ${CMAKE_CURRENT_SOURCE_DIR}/Config.cmake.in
  "${CMAKE_CURRENT_BINARY_DIR}/MySharedTargetConfig.cmake"
  INSTALL_DESTINATION "cmake"
  NO_SET_AND_CHECK_MACRO
  NO_CHECK_REQUIRED_COMPONENTS_MACRO
  )

install(
  FILES
  ${CMAKE_CURRENT_BINARY_DIR}/MySharedTargetConfig.cmake
  DESTINATION cmake
  )

上述代码会在安装路径中生成规范的目录结构。若将该路径添加至其他项目的CMAKE_PREFIX_PATH，find_package和target_link_libraries均可正常工作：

list(PREPEND CMAKE_PREFIX_PATH
    "my_shared_library_folder"
)

find_package(MySharedLibrary CONFIG REQUIRED)

链接该共享库的客户端项目编译正常，但运行时无法找到共享库（DLL）。请问CMake的惯用处理方式是什么？能否让CMake将运行时文件复制到可执行文件路径？或有其他推荐方案？

针对Windows下DLL运行时查找问题，CMake有几种惯用处理方式，分开发阶段和部署阶段两类：

1. 构建时自动复制DLL到可执行目录（开发阶段首选） #

在客户端项目的CMakeLists.txt中，给可执行目标添加POST_BUILD自定义命令，自动收集并复制依赖的DLL到可执行文件输出目录：

add_executable(MyClient main.cpp)
target_link_libraries(MyClient PRIVATE MySharedTarget)

# 复制依赖的所有运行时DLL到可执行输出目录
add_custom_command(TARGET MyClient POST_BUILD
    COMMAND ${CMAKE_COMMAND} -E copy_if_different
        $<TARGET_RUNTIME_DLLS:MyClient>
        $<TARGET_FILE_DIR:MyClient>
    COMMAND_EXPAND_LISTS
)

• $<TARGET_RUNTIME_DLLS:MyClient>：CMake自动解析目标依赖的所有Windows运行时DLL（包括你的共享库DLL和系统依赖DLL）
• copy_if_different：仅当DLL有更新时才复制，避免重复操作
• COMMAND_EXPAND_LISTS：确保列表中的每个DLL都被单独处理

2. 调试时自动设置PATH（Visual Studio专属） #

如果使用Visual Studio开发，可以给可执行目标设置调试环境变量，把共享库DLL所在目录加入PATH，无需手动复制DLL：

add_executable(MyClient main.cpp)
target_link_libraries(MyClient PRIVATE MySharedTarget)

# 给VS调试器设置PATH，直接指向共享库DLL的输出/安装目录
set_target_properties(MyClient PROPERTIES
    VS_DEBUGGER_ENVIRONMENT "PATH=$<TARGET_FILE_DIR:MySharedTarget>;%PATH%"
)

这个方案的优势是不会产生冗余文件，调试时直接使用共享库的原始DLL文件，适合开发迭代阶段。

3. 部署阶段统一目录结构 #

如果是正式部署，可以调整共享库的安装路径，让DLL和客户端可执行文件处于同一目录：

• 修改共享库项目中的install命令，将RUNTIME DESTINATION设为和客户端可执行文件相同的目录（比如bin/$<CONFIG>）
• 或者在客户端的安装脚本中，添加复制共享库DLL到部署目录的逻辑：

# 客户端安装时复制共享库DLL
install(
    FILES $<TARGET_FILE:MySharedTarget>
    DESTINATION bin/$<CONFIG>
)

4. 临时设置PATH（仅用于测试） #

不建议手动修改系统PATH环境变量（易导致环境污染和版本冲突），如果是临时测试，可以在命令行中临时设置：

set PATH=my_shared_library_folder\bin\Debug;%PATH%
MyClient.exe

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