CCache配置问题：同一项目在不同目录下无法复用缓存

我正尝试为CMake项目配置CCache，用于CI/CD系统，先在本地测试。但无论如何都无法让CCache在同一项目处于不同目录时正确复用缓存——我的CI/CD系统中多个任务会将项目检出到不同目录（含随机生成名称的目录）。

目前仅能实现项目根目录下不同build目录的部分缓存复用，例如名为foo的项目：

• foo
  • build_debug_1
  • build_debug_2
    但无法实现如下场景的缓存复用：
• projects
  • foo
    • build_debug
• other_projects
  • foo
    • build_debug

即便在前一种场景下，也无法达到清空build目录后重建那样的100%缓存命中率。

另外我有个疑问：CCache的目标之一是支持多用户甚至多服务器共享缓存，除非我误解了这类使用场景或正确配置方式，否则若不同用户/系统的项目文件系统路径不一致，CCache如何实现该功能？

当前CMake中启用CCache的代码如下：

find_program(CCACHE_PROGRAM ccache)
if (CCACHE_PROGRAM)
    message(NOTICE "Selected CCache: ${CCACHE_PROGRAM}")
    set_property(GLOBAL PROPERTY RULE_LAUNCH_COMPILE "${CCACHE_PROGRAM}")
    set_property(GLOBAL PROPERTY RULE_LAUNCH_LINK "${CCACHE_PROGRAM}")
    get_filename_component(PARENT_DIR ${PROJECT_SOURCE_DIR} DIRECTORY)
    set(ENV{CCACHE_BASEDIR} "${PARENT_DIR}")
    set(ENV{CCACHE_SLOPPINESS} "pch_defines,file_macro,include_file_ctime")
    set(ENV{CCACHE_NOHASHDIR} "1")
else ()
    message(WARNING "Could not find ccache, skipping!")
endif ()

核心配置问题 #

配置里CCACHE_BASEDIR设为项目的父目录，导致不同父目录下的项目被识别为不同上下文，无法复用缓存。另外CCACHE_SLOPPINESS参数不够全面，且启用链接阶段的CCache意义不大，反而可能引发问题。

修正后的CMake配置 #

find_program(CCACHE_PROGRAM ccache)
if (CCACHE_PROGRAM)
    message(NOTICE "Selected CCache: ${CCACHE_PROGRAM}")
    # 仅为编译阶段启用CCache，链接阶段无需缓存
    set_property(GLOBAL PROPERTY RULE_LAUNCH_COMPILE "${CCACHE_PROGRAM}")
    
    # 将基准目录设为项目源码根目录，以内部相对路径生成哈希
    set(ENV{CCACHE_BASEDIR} "${PROJECT_SOURCE_DIR}")
    # 强制忽略源码绝对路径的哈希计算
    set(ENV{CCACHE_NOHASHDIR} "1")
    # 扩展宽松参数，适配跨目录编译场景
    set(ENV{CCACHE_SLOPPINESS} "pch_defines,file_macro,include_file_ctime,include_file_mtime,time_macros")
    
    # 可选：开启日志排查缓存未命中问题
    # set(ENV{CCACHE_LOGFILE} "${CMAKE_BINARY_DIR}/ccache.log")
else ()
    message(WARNING "Could not find ccache, skipping!")
endif ()

关键配置解读 #

• CCACHE_BASEDIR：设为${PROJECT_SOURCE_DIR}后，CCache会以项目内部的相对路径为基准生成哈希，不受外部父目录变化影响。
• CCACHE_NOHASHDIR：必须设为1，这是让CCache忽略源码绝对路径的核心开关，是跨目录复用缓存的前提。
• CCACHE_SLOPPINESS：新增include_file_mtime和time_macros，允许CCache忽略文件修改时间的微小差异、编译时的时间宏（如__DATE__），减少不必要的缓存未命中。
• 关闭链接阶段缓存：链接操作的缓存命中率极低，且容易因路径问题失效，仅保留编译阶段的CCache即可。

额外优化建议 #

• 确保CI/CD所有任务使用相同版本的编译器和编译参数，环境不一致会导致缓存无法复用。
• 执行ccache -C清空旧缓存后再测试，避免之前错误配置的缓存干扰结果。
• 用ccache -s查看缓存统计，或开启日志定位缓存未命中的具体原因。

跨用户/服务器共享缓存的原理 #

CCache实现跨路径、跨环境共享缓存的核心是基于内容而非路径的哈希计算：

• 通过CCACHE_BASEDIR和CCACHE_NOHASHDIR剥离绝对路径的影响，只以源码内容、编译参数、编译器版本等与编译结果直接相关的因素生成哈希。
• 配合共享缓存存储（如NFS共享目录、Redis后端），不同用户或服务器只要编译环境一致，就能复用同一缓存条目。

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