CMake问题：修改GCC -imacros引用的配置头文件未触发重建

这个问题我之前也碰到过——CMake默认不会去解析你通过编译器参数（比如-imacros）引用的文件，所以它根本不知道这个配置头文件和你的编译目标有关联，自然不会在文件修改时触发重建。下面给你两种靠谱的解决办法：

方法1：全局追踪配置头文件变化 #

如果你这个配置头是整个项目所有C目标都依赖的，可以直接告诉CMake把它当成配置依赖项，这样修改文件时会自动触发CMake重新配置+全量编译：

# 先定义你的配置头文件路径
set(MY_CONFIG_HEADER "${PROJECT_SOURCE_DIR}/path/to/your/config.h")

# 把-imacros加入C编译选项
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -imacros \"${MY_CONFIG_HEADER}\"")

# 关键：让CMake追踪这个文件的变化
set_property(DIRECTORY APPEND PROPERTY CMAKE_CONFIGURE_DEPENDS ${MY_CONFIG_HEADER})

方法2：针对单个目标添加依赖（更推荐） #

如果只有部分目标依赖这个配置头，或者你想更精准地控制编译触发范围，直接给目标添加头文件依赖就行，这样修改文件时只会重新编译对应的目标，效率更高：

set(MY_CONFIG_HEADER "${PROJECT_SOURCE_DIR}/path/to/your/config.h")
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -imacros \"${MY_CONFIG_HEADER}\"")

# 比如你的目标是my_app
add_executable(my_app src/main.c)

# 将配置头文件添加为目标的私有源文件，CMake会自动追踪它的变化
target_sources(my_app PRIVATE ${MY_CONFIG_HEADER})

# 标记这个文件为仅头文件，避免CMake尝试去编译它（毕竟头文件不需要编译）
set_source_files_properties(${MY_CONFIG_HEADER} PROPERTIES HEADER_FILE_ONLY TRUE)

原理说明 #

CMake的依赖追踪是基于它知道的源码文件列表，而-imacros是传递给GCC的参数，CMake不会主动解析这个参数里的文件路径，所以必须手动把配置头文件加入到CMake的依赖追踪体系里，不管是全局配置依赖还是目标级的源码依赖，本质都是让CMake意识到：这个文件变了，相关的编译任务得重新跑一遍。

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