如何通过缓存与制品加速GitLab CI中的Rust项目测试任务

核心思路 #

本地构建快是因为cargo会缓存依赖包和编译产物，而GitLab CI每次都是全新环境，所以要把这些缓存目录同步到CI环境里，避免重复编译。

优化后的.gitlab-ci.yml配置 #

stages:
  - test

test:
  stage: test
  image: rust:latest
  # 配置GitLab缓存，保存依赖索引和编译产物
  cache:
    key:
      # 用Cargo.lock的哈希值作为缓存键，依赖变更时自动重建缓存
      files:
        - Cargo.lock
    paths:
      # 保存cargo的依赖索引缓存
      - ~/.cargo/registry/
      # 保存项目的编译产物（包括依赖库和二进制文件）
      - target/
    # 缓存仅在当前分支生效，避免分支间缓存污染
    policy: pull-push
  script:
    # 用--locked确保依赖版本与Cargo.lock一致，避免意外更新导致缓存失效
    - cargo test --locked

关键配置说明 #

• 缓存键（key）：基于Cargo.lock文件哈希生成，只有当依赖版本变更时才会重新生成缓存，保证缓存的有效性。
• 缓存路径（paths）：
  • ~/.cargo/registry/：存放cargo下载的依赖包索引和源码，避免每次重新下载依赖。
  • target/：存放编译后的依赖库和项目二进制文件，避免重复编译。
• 缓存策略（policy）：pull-push表示任务开始时拉取缓存，结束时推送更新后的缓存，适合大多数场景。
• --locked参数：强制使用Cargo.lock中的依赖版本，防止CI环境中意外拉取新版本依赖，导致缓存失效。

额外优化建议 #

• 如果项目依赖较多，可以用sccache（共享编译缓存），在多个CI任务间共享编译结果：

  - apt-get update && apt-get install -y sccache
  - export RUSTC_WRAPPER=sccache
  - cargo test --locked
  

• 固定Rust镜像版本（比如rust:1.75），避免因镜像更新导致环境变化，影响缓存兼容性。

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