CMake何时需要重新配置？构建流程与检测机制疑问

为何无需重新执行配置步骤？ #

第一次在构建目录运行CMake配置时，已经生成了CMakeCache.txt（存储配置参数缓存）、Makefile（或对应构建器的构建文件）及其他辅助文件。cmake --build .本质是调用底层构建工具（如Make、Ninja），这些生成的构建文件已关联好必要的依赖逻辑，只要源码的CMake配置未发生需要重建构建文件的变更，直接执行构建就能完成增量编译，无需重复配置。

Makefile能检测CMakeLists.txt的变化吗？ #

可以。CMake生成的Makefile会包含对源码目录下CMakeLists.txt及相关.cmake配置文件的依赖检查逻辑：
Makefile中会生成一个特殊目标（比如cmake_check_build_system），所有构建目标都会依赖它。执行构建时会先触发cmake -E check_build_system命令，该命令会对比构建目录缓存与源码配置文件的时间戳、内容哈希，一旦发现配置文件变更，会自动重新执行配置步骤，更新Makefile和其他构建文件。

你能在生成的Makefile中看到类似片段：

cmake_check_build_system:
	$(CMAKE_COMMAND) -S$(CMAKE_SOURCE_DIR) -B$(CMAKE_BINARY_DIR) --check-build-system CMakeFiles/Makefile.cmake 0
.PHONY : cmake_check_build_system

哪些情况需要手动重新执行配置步骤？ #

• 修改了CMakeLists.txt或相关.cmake文件，但底层构建工具的自动检查未触发重新配置（多因缓存异常导致）
• 需要修改CMake配置参数（比如添加-DCMAKE_BUILD_TYPE=Release、-DENABLE_FEATURE=ON这类选项），这类参数存在CMakeCache.txt中，直接构建不会更新缓存
• 切换了构建工具链（比如从GCC换成Clang，或修改交叉编译工具路径）
• 添加了新的源码目录/外部依赖，且CMakeLists.txt未通过file(GLOB)这类自动扫描方式处理，需重新生成构建文件的依赖关系
• 构建目录的缓存文件损坏（如CMakeCache.txt被误改或删除）

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