CMake TARGET模式add_custom_command如何添加文件依赖

不需要额外创建独立自定义目标，仅需修改现有CMake配置即可同时满足「构建App目标必执行脚本、脚本修改自动触发重跑」的要求，参考配置如下：

add_executable(App src/main.cpp)

# 将Python脚本加入App目标的源文件列表，建立依赖关联
target_sources(App PRIVATE
    scripts/do_stuff.py
)

# 配置脚本文件属性，避免CMake尝试编译该非源码文件
set_source_files_properties(scripts/do_stuff.py PROPERTIES
    HEADER_FILE_ONLY ON
    EXTERNAL_OBJECT TRUE
)

add_custom_command(
        TARGET App
        POST_BUILD
        COMMAND "${Python3_EXECUTABLE}" ARGS "scripts/do_stuff.py" "$<TARGET_FILE:App>"
        WORKING_DIRECTORY "${CMAKE_CURRENT_LIST_DIR}"
)

实现逻辑 #

• 将脚本通过target_sources加入目标后，CMake会自动跟踪该文件的修改时间：只要脚本改动时间晚于App可执行文件的生成时间，构建系统就会判定App目标过期，自动触发链接流程+所有POST_BUILD步骤，也就是自动重跑你的处理脚本。
• 给脚本设置HEADER_FILE_ONLY ON属性，是告诉CMake这个文件不需要参与编译，避免把Python脚本当成C++源码处理触发编译错误；补充EXTERNAL_OBJECT TRUE做双保险，兼容不同生成器的处理逻辑，避免异常。
• 该方案完全保留了POST_BUILD命令和App目标的绑定关系：无论用户直接构建App，还是App被其他上层目标依赖构建，处理脚本都会强制执行，不存在被绕过的可能。

常见误区说明 #

• TARGET模式的add_custom_command原生不支持DEPENDS参数，即使强行写入该字段也会被CMake忽略，无法实现文件依赖跟踪。
• add_dependencies命令仅支持添加CMake构建目标作为依赖，无法直接关联磁盘上的普通文件，直接传入脚本路径会触发报错。
• 单独创建自定义目标再做关联的方案会引入冗余目标，配置不当反而可能出现构建顺序问题，不如直接绑定目标源文件的方案简洁可靠。

补充提示：如果你的处理脚本还依赖其他Python模块/配置文件，只需要把这些关联文件也通过target_sources加入App目标，设置相同的文件属性即可，这些文件改动时也会触发处理脚本重跑。

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