CMake+Vcpkg发布模式安装问题：如何仅复制必要运行依赖

问题根源 #

Debug模式下CMake会自动将必要依赖复制到构建目录，所以程序能正常运行；但默认install规则仅复制主程序EXE，而install(IMPORTED_RUNTIME_ARTIFACTS)会拉取整个OpenCV包的所有库，无法实现按需复制。

解决方案 #

1. 用CMake运行时依赖自动收集逻辑 #

使用CMake的file(GET_RUNTIME_DEPENDENCIES)命令配合生成器表达式，精准收集主程序实际依赖的运行时库，和构建目录的依赖复制效果完全一致：

# 先安装主程序到目标目录
install(TARGETS your_main_exe
        RUNTIME DESTINATION bin
        COMPONENT Runtime)

# 自动收集并安装实际依赖的DLL
install(CODE "
  file(GET_RUNTIME_DEPENDENCIES
    EXECUTABLES $<TARGET_FILE:your_main_exe>
    RESOLVED_DEPENDENCIES_VAR _resolved_deps
    UNRESOLVED_DEPENDENCIES_VAR _unresolved_deps
    CONFLICTING_DEPENDENCIES_VAR _conflicting_deps
    DIRECTORIES $<TARGET_FILE_DIR:your_main_exe>
  )

  # 输出警告提示未解析/冲突的依赖（可选）
  if(_unresolved_deps)
    message(WARNING \"Unresolved runtime dependencies: \${_unresolved_deps}\")
  endif()
  if(_conflicting_deps)
    message(WARNING \"Conflicting runtime dependencies: \${_conflicting_deps}\")
  endif()

  # 复制所有解析到的依赖DLL到安装目录
  foreach(_dep IN LISTS _resolved_deps)
    file(INSTALL
      DESTINATION \"\${CMAKE_INSTALL_PREFIX}/bin\"
      TYPE SHARED_LIBRARY
      FILES \"\${_dep}\"
      FOLLOW_SYMLINK_CHAIN)
  endforeach()
" COMPONENT Runtime)

2. 配合Vcpkg清单精简依赖 #

在vcpkg.json中仅声明项目实际用到的OpenCV组件，避免Vcpkg安装冗余库：

{
  "name": "your-project",
  "version": "1.0.0",
  "dependencies": [
    {
      "name": "opencv",
      "features": ["core", "imgproc", "highgui"]
    }
  ]
}

3. 验证安装结果 #

执行cmake --install build --config Release后，检查安装目录的bin文件夹，只会包含主EXE和实际用到的依赖DLL，与out/build/x64-release目录的文件完全匹配。

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