C/C++ 与 Rust 编译缓存治理：ccache 与 sccache 在 CI 中的配置实践- 惊觉

C/C++ 与 Rust 编译缓存治理：ccache 与 sccache 在 CI 中的配置实践

封面信息图

在以 C/C++ 或 Rust 为核心的高性能系统级项目（如高性能网关、分布式存储引擎、量化交易核心）中，持续集成（CI）流水线面临的最大痛点是**“令人绝望的漫长编译耗时”**。

在无状态的 CI 容器中，由于每次构建都是一个纯净环境，缺少本地编译缓存，哪怕开发者只修改了一个源文件中的一行日志，流水线也不得不将数百万行的依赖库（如 Boost、LLVM、gRPC、Tokio）全量重新编译一遍。一次完整的 CI 运行耗时动辄 25~45 分钟，将开发者的反馈循环拉长到了几乎无法忍受的地步。

通过在 CI 流水线中深度引入 ccache（面向 C/C++） 与 sccache（Mozilla 开发的跨平台/跨语言/支持 S3 云端分布式缓存的工具，完美支持 Rust/C/C++），我们可以将未修改目标文件的编译过程直接转化为毫秒级的缓存解压，实测将大型系统的 CI 编译时间从 35 分钟直接压缩至 2.5 分钟（提速 14 倍）。

编译缓存的工作原理

ccache 与 sccache 充当了编译器（gcc、clang、rustc）的智能代理包装器：

graph LR
    A[编译器调用: rustc / clang main.cpp] --> B[sccache 拦截编译命令]
    B --> C[计算: 预处理源码哈希 + 编译参数 + 编译器版本 SHA256]
    C --> D{云端对象存储 MinIO / S3 是否存在该哈希?}
    D -->|命中 Cache Hit| E[直接下载目标 .o / .rlib 文件 耗时 5ms!]
    D -->|未命中 Cache Miss| F[调用真实编译器编译 -> 异步将产物推入 S3]

sccache 基于 S3 / MinIO 分布式后端实战配置

在企业内网中，搭建一个 MinIO 对象存储桶 ci-compiler-cache，让所有并发运行的 CI Runner Pod 共享同一个云端编译缓存池。

1. Dockerfile 中预装 sccache

FROM rust:1.80-bullseye

# 安装 sccache 二进制
RUN cargo install sccache --version ^0.8 --locked

# 设置环境变量将 rustc 默认包装为 sccache
ENV RUSTC_WRAPPER="/usr/local/cargo/bin/sccache"
ENV SCCACHE_BUCKET="ci-compiler-cache"
ENV SCCACHE_ENDPOINT="http://minio.internal.domain:9000"
ENV SCCACHE_S3_USE_SSL="false"

2. GitLab CI / GitHub Actions 流水线中的调用配置

# .gitlab-ci.yml 中的 Rust 极速编译 Job
rust_build_and_test:
  stage: build
  image: rust-ci-base:1.80
  variables:
    AWS_ACCESS_KEY_ID: "$MINIO_CI_ACCESS_KEY"
    AWS_SECRET_ACCESS_KEY: "$MINIO_CI_SECRET_KEY"
    SCCACHE_LOG: "info"
  before_script:
    # 启动 sccache 后台守护服务
    - sccache --start-server
    # 重置统计计数器
    - sccache --zero-stats
  script:
    - cargo build --release
    - cargo test --release
  after_script:
    # 打印本次编译的缓存命中率统计
    - sccache --show-stats

ccache 在 C/C++ 与 CMake 工程中的标准配置

对于使用 CMake 构建的大型 C++ 工程，通过在 CMakeLists.txt 或命令行参数中指定编译器包装器：

# 运行 CMake 构建时无缝接入 ccache
cmake -B build \
  -DCMAKE_C_COMPILER_LAUNCHER=ccache \
  -DCMAKE_CXX_COMPILER_LAUNCHER=ccache \
  -DCMAKE_BUILD_TYPE=Release

cmake --build build -j$(nproc)

缓存治理中的三大避坑指南

消除编译参数中的“时间戳与随机宏”：如果在 C++ 代码中使用了 __DATE__ 或 __TIME__ 宏，或者编译器开启了带绝对路径的调试信息（-g），会导致每次编译生成的预处理哈希完全不同，从而导致缓存命中率暴跌为 0%。必须添加编译参数 -ffile-prefix-map=$PWD=. 抹平绝对路径。
定期清理冷过期的旧缓存：在 MinIO / S3 存储桶上配置生命周期规则（Lifecycle Rule），自动清理超过 14 天未被命中的历史缓存切片，防止对象存储磁盘被无限撑爆。
监控缓存命中率指标：在 CI 阶段解析 sccache --show-stats 输出，将 Cache hits rate（缓存命中率）作为效能指标上报至 Prometheus。健康工程的日常命中率应稳定在 80%~95% 之间。

提速收益对比

我们在一个包含 45 万行 C++ 与 15 万行 Rust 的高性能网关项目上进行了实测对比：

编译场景	原生无缓存全量编译	sccache 分布式缓存命中 (90%)	提速倍数
C++ 模块 Release 编译	18 分 40 秒	1 分 15 秒	15.0 倍
Rust 全量依赖编译	15 分 20 秒	1 分 05 秒	14.2 倍
PR 平均 CI 等待耗时	34 分钟	2 分 20 秒	极速交付

让编译器不再重复计算一模一样的代码，用分布式缓存消解底层语言的编译包袱，是保障高性能系统工程敏捷交付的核心支柱。

转载自 CSDN-专业IT技术社区

原文链接：https://blog.csdn.net/2401_83508463/article/details/165614081

C/C++ 与 Rust 编译缓存治理：ccache 与 sccache 在 CI 中的配置实践