CMake问题：生成头文件更新时关联可执行文件未重新编译

问题原因 #

当生成的ExampleData.h更新时，静态库ExampleLib会重新编译，但链接它的ExampleExecutable未重新编译/链接，核心原因是：

• 如果ExampleExecutable的代码依赖ExampleData.h中的编译期静态数据（如常量、模板实例），仅重新链接静态库不足以生效，必须重新编译ExampleExecutable的源文件。
• CMake默认未感知到ExampleExecutable与ExampleData.h的依赖关系，因此不会触发其重新编译。

具体解决方案 #

方案一：直接声明可执行文件对生成头文件的依赖 #

修改CMake配置，让ExampleExecutable明确依赖ExampleData.h，确保头文件更新时触发重新编译：

add_executable(ExampleExecutable test/ExampleExecutable.cc)
# 添加生成头文件作为可执行文件的依赖源，触发重新编译
target_sources(ExampleExecutable PRIVATE ${GENERATED_DIR}/ExampleData.h)
# 确保生成头文件的任务完成后再编译可执行文件
add_dependencies(ExampleExecutable ExampleData)
target_link_libraries(ExampleExecutable ExampleLib)

方案二：通过静态库传递依赖（更规范） #

使用target_include_directories的PUBLIC属性传递头文件目录，让依赖链自动传递，同时添加目标依赖：

# 替换原include_directories，改用目标专属的包含目录配置
add_library(ExampleLib STATIC gen/ExampleData.cc ${GENERATED_DIR}/ExampleData.h)
target_include_directories(ExampleLib PUBLIC ${GENERATED_DIR})
add_dependencies(ExampleLib ExampleData)

add_executable(ExampleExecutable test/ExampleExecutable.cc)
target_link_libraries(ExampleExecutable ExampleLib)
# 确保生成头文件完成后再编译可执行文件
add_dependencies(ExampleExecutable ExampleData)

方案三：使用OBJECT库跟踪细粒度依赖 #

如果静态库仅包含与生成头文件相关的代码，改用OBJECT库可以让CMake更精准地跟踪依赖：

# 创建OBJECT库，保存编译后的目标文件
add_library(ExampleLib OBJECT gen/ExampleData.cc ${GENERATED_DIR}/ExampleData.h)
target_include_directories(ExampleLib PUBLIC ${GENERATED_DIR})
add_dependencies(ExampleLib ExampleData)

# 基于OBJECT库创建可执行文件
add_executable(ExampleExecutable test/ExampleExecutable.cc $<TARGET_OBJECTS:ExampleLib>)
target_include_directories(ExampleExecutable PRIVATE ${GENERATED_DIR})
add_dependencies(ExampleExecutable ExampleData)

额外检查点 #

1. 确认ExampleExecutable.cc直接或间接包含了ExampleData.h，否则头文件更新不会触发其重新编译。
2. 清理构建目录后重新测试，避免旧缓存文件干扰结果。

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