BE 多目录共享缓存
在与 AI Agent 协作进行 Doris BE 开发时，一种常见的模式是利用 git worktree 等方式同时在不同目录下维护多个开发分支，并行开发。由于 ccache 缓存对全路径名敏感，因此在不同的目录中，即使绝大多数 cpp 文件内容相同，ccache 也无法命中缓存，导致 worktree 目录必须从零开始编译，极大拖慢开发速度。为解决这一问题，我们进行了定制的优化，按以下方式配置即可：
目录要求
Doris 已经在环境配置文件中设定了 CCACHE_BASEDIR 和 -ffile-prefix-map，对于绝大多数编译选项已经映射为同一路径，以便缓存命中。**它的前提是所有 Doris 开发目录必须共享相同的父目录。**即所有 Doris 开发目录必须满足：
xxx/doris_main
xxx/doris1
xxx/doris2
如上所示的并列关系。
环境配置
- 除上述设定外，硬编码路径仍需要手动调整，需要在 worktree 目录的
custom_env.sh中硬编码主库的 UBSAN IGNORELIST：
export UBSAN_IGNORELIST=${DORIS_MAIN_REPO}/conf/ubsan_ignorelist.txt
其中 DORIS_MAIN_REPO 是主库的路径。我们推荐将该值直接配置在主库的 custom_env.sh 中，通过 hooks/setup_worktree.sh 和 AGENTS.md 的配合，由 AI 工作流自动传递给所有 worktree 目录。
- 为保证缓存空间足够，请手动扩大 ccache 缓存容量：
ccache --set-config=max_size=50G
调试方式
可以通过 ccache -s 来查看缓存统计信息，确认缓存是否生效。重点关注 cache hit rate 字段，如果值过低说明缓存未正确命中。每次观测前可以通过 ccache -z 清空统计信息以确保结果准确。确认缓存命中有问题时，可以开启 ccache Debug 日志来确认：
export CCACHE_LOGFILE=/path/to/xxx
export CCACHE_DEBUG=1
在 CCACHE_LOGFILE 中可以查看详细的缓存命中情况，帮助定位问题。开启 CCACHE_DEBUG=1 后，每一个编译单元都会产生自己的 *.ccache-input-text 文件，记录该编译单元的输入信息，包括源文件路径、编译选项等。理论上两个不同目录的相同文件，**各自的 ccache-input-text 内容需要完全一致，才能命中 ccache 缓存。**对于未命中的文件，可以查看两侧 ccache-input-text 文件差异明确未命中原因。
