如何通过cmake --install仅复制指定文件（以Qt6Widgetsd.dll为例）

问题原因 #

cmake --install本身不支持直接传入单个文件路径作为参数，它仅接受项目目录、编译目标或组件作为输入，直接指定文件会触发参数格式报错。以下是几种高效替代方案：

方案1：手动复制（最直接） #

1. 定位编译生成的目标文件路径：
   • Debug版本的Qt6Widgetsd.dll通常在源码编译目录的bin子文件夹下（部分Qt模块可能在lib目录）
2. 直接复制到Qt安装目录对应位置：
   • 比如你的Qt安装路径为D:\Qt\6.5.2\msvc2019_64，就把文件复制到D:\Qt\6.5.2\msvc2019_64\bin
   • 若存在对应的Qt6Widgetsd.pdb调试符号文件，建议一并复制，方便后续调试

方案2：指定单个编译目标执行cmake --install #

利用cmake的--target参数，仅处理指定模块的安装规则，避免遍历全量文件：

# 安装Qt6Widgets模块的所有相关文件（含dll、库、头文件等）
cmake --install . --target Qt6Widgets

# 仅安装Debug版本
cmake --install . --target Qt6Widgets --config Debug

这个命令只会处理Qt6Widgets模块的安装逻辑，速度远快于全量cmake --install .

方案3：自定义cmake脚本（适合频繁操作） #

编写极简cmake脚本实现精准复制，创建install_widgets_dll.cmake文件：

# 替换为你的编译生成文件路径和Qt目标路径
set(SOURCE_FILE "${CMAKE_CURRENT_BINARY_DIR}/bin/Qt6Widgetsd.dll")
set(TARGET_DIR "D:/Qt/6.5.2/msvc2019_64/bin")

file(COPY "${SOURCE_FILE}" DESTINATION "${TARGET_DIR}")
# 可选：复制调试符号文件
file(COPY "${CMAKE_CURRENT_BINARY_DIR}/bin/Qt6Widgetsd.pdb" DESTINATION "${TARGET_DIR}")

执行脚本完成复制：

cmake -P install_widgets_dll.cmake

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