CMake中file(COPY)无法覆盖现有文件的问题及优化方案咨询

问题背景 #

需要将特定目录下的XML文件复制到目标文件夹，且允许后复制的文件覆盖先复制的同名文件，但使用file(COPY)命令时发现无法覆盖——即使调换复制顺序（先custom再common）能避免被覆盖，但逻辑不够直观。不想逐个文件用file(COPY_FILE)，也无法修改文件时间戳。

用户原有实现代码：

file(COPY ${CMAKE_CURRENT_SOURCE_DIR}/common/ DESTINATION ${CMAKE_CURRENT_BINARY_DIR}/tmp/ FILES_MATCHING PATTERN "*.xml")

if(MY_OPTION)
    file(COPY ${CMAKE_CURRENT_SOURCE_DIR}/custom/ DESTINATION ${CMAKE_CURRENT_BINARY_DIR}/tmp/ FILES_MATCHING PATTERN "*.xml")
endif()

可行解决方案 #

方案一：使用file(INSTALL)替代file(COPY) #

file(INSTALL)命令默认强制覆盖现有文件，不受文件时间戳影响，参数用法与file(COPY)基本一致，完全适配需求：

file(INSTALL ${CMAKE_CURRENT_SOURCE_DIR}/common/ DESTINATION ${CMAKE_CURRENT_BINARY_DIR}/tmp/ FILES_MATCHING PATTERN "*.xml")

if(MY_OPTION)
    file(INSTALL ${CMAKE_CURRENT_SOURCE_DIR}/custom/ DESTINATION ${CMAKE_CURRENT_BINARY_DIR}/tmp/ FILES_MATCHING PATTERN "*.xml")
endif()

此方案下，custom目录的XML文件会正常覆盖common目录的同名文件，逻辑直观符合预期。

方案二：先清理目标文件再执行复制 #

若坚持使用file(COPY)，可在复制前删除目标目录中待覆盖的文件，确保file(COPY)因目标文件不存在而执行复制操作：

# 删除目标目录下所有XML文件，为后续复制清空环境
file(REMOVE ${CMAKE_CURRENT_BINARY_DIR}/tmp/*.xml)

# 复制common目录的XML文件
file(COPY ${CMAKE_CURRENT_SOURCE_DIR}/common/ DESTINATION ${CMAKE_CURRENT_BINARY_DIR}/tmp/ FILES_MATCHING PATTERN "*.xml")

# 开启选项时，复制custom目录的XML文件覆盖同名文件
if(MY_OPTION)
    file(COPY ${CMAKE_CURRENT_SOURCE_DIR}/custom/ DESTINATION ${CMAKE_CURRENT_BINARY_DIR}/tmp/ FILES_MATCHING PATTERN "*.xml")
endif()

原因说明 #

file(COPY)默认仅在源文件时间戳晚于目标文件时才会执行覆盖操作，当两者时间戳相同时则跳过覆盖。而file(INSTALL)无此限制，会强制覆盖现有文件，这正是两种命令的核心差异点。

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