ccache

C/C++ 编译缓存

补充说明

ccache 缓存编译器输出，命中时直接复用目标文件，显著加速重复编译。它通过编译器包装器工作，适合本地和 CI。

常用示例

ccache gcc -c app.c
ccache g++ -c app.cpp -o app.o
ccache --show-stats
ccache --zero-stats
ccache --clear
ccache -C
ccache --show-config
ccache --max-size=10G
export CCACHE_DIR=/var/cache/ccache

CMake 集成：

cmake -S . -B build -DCMAKE_C_COMPILER_LAUNCHER=ccache -DCMAKE_CXX_COMPILER_LAUNCHER=ccache

易错点与排错

• 编译器/参数/头文件变化会失效缓存；命中率低先看 --show-stats。
• 绝对路径、时间宏（__TIME__）和随机宏会降低命中率。
• CI 要缓存 CCACHE_DIR，否则每次都是冷启动。
• CCACHE_DISABLE=1 可临时绕过；不要用它掩盖构建问题。
• 远程缓存需要网络和认证；配置错误会拖慢构建。
• 缓存目录会增长；设置 max_size 和清理策略。
• ccache 不替代依赖跟踪；改头文件后仍要正确重建。

相关命令

• ccache — 编译缓存
• cmake / ninja — 构建系统
• gcc / clang — 编译器