如何配置ccache排除特定文件校验 解决git分支切换后缓存不命中问题

避免切换分支后不必要重编译的配置 #

出现这个问题的核心原因有两个：一是Git切换分支时会重置工作区文件的修改时间(mtime)，ccache默认会同时校验文件mtime和内容哈希，mtime变化会直接判定缓存不命中；二是如果代码中使用了__TIME__/__DATE__等时间宏，每次编译的宏值不同也会导致缓存失效。
按以下优先级配置即可解决：

• 配置ccache忽略文件mtime和时间宏差异，执行全局配置命令：
  ccache --set-config=sloppiness=file_mtime,time_macros
  也可以临时生效，在构建前导出环境变量：
  export CCACHE_SLOPPINESS=file_mtime,time_macros
• 如果项目有自动生成的版本头文件（比如内置Git commit hash），建议修改CMake生成逻辑，仅当版本号实际变化时才更新头文件内容，避免无意义的mtime变更。
• 确认ccache未开启工作目录哈希校验，执行ccache --get-config=hash_dir，如果返回true可以执行ccache --set-config=hash_dir=false关闭，避免构建目录路径的微小变化导致缓存失效。

配置ccache排除特定文件校验 #

根据你要排除的文件类型选择对应方案：

排除头文件校验 #

如果要让ccache在计算缓存哈希时忽略某些头文件的变化，可以配置ignore_headers参数：

# 全局配置，多个路径用冒号分隔（Linux/macOS）
ccache --set-config=ignore_headers="/path/to/first.h:/path/to/second.h"
# 临时生效环境变量
export CCACHE_IGNOREHEADERS="/path/to/first.h:/path/to/second.h"

ccache 4.0及以上版本支持通配符匹配，比如/path/to/dir/*.h可以匹配指定目录下所有头文件。

排除源文件走ccache校验 #

如果是特定源文件不需要走ccache缓存，可以在CMakeLists.txt中单独配置该文件的编译启动器为空，跳过ccache调用：

set_source_files_properties(
    src/auto_generated.cpp
    src/version.cpp
    PROPERTIES CXX_COMPILER_LAUNCHER ""
)

注意：如果你的业务逻辑依赖__TIME__/__DATE__宏的实时性，不要添加time_macros到sloppiness配置中，否则会导致时间宏不会随编译更新。

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