GitLab CI中仅重建更新文件的可行方案咨询

这个问题我之前帮不少开发者解决过，核心痛点在于GitLab CI默认的clone策略会每次重置仓库的工作区，所有文件的修改时间都会被更新成Job启动的时间，导致make认为所有源码都变了，只能全量构建。下面给你拆解可行的方案，以及最优解：

为什么不推荐缓存src目录？ #

先直接说结论：不要缓存src目录。原因很简单：

• src属于仓库的核心代码，缓存它会导致新旧代码冲突——比如你切换分支后，缓存里的旧src可能和新拉取的代码混在一起，构建出的产物根本不是基于最新代码的
• 不同分支的缓存如果共用同一个key，会互相覆盖，出现莫名其妙的构建错误
• src目录体积通常不小，缓存它会拖慢缓存的上传/下载速度，反而降低CI效率

方案1：用GIT_STRATEGY: fetch保留工作区状态（最优解） #

这是最适合大多数项目的方案，原理是让GitLab Runner不要每次重新克隆仓库，而是通过fetch拉取最新代码，保留之前工作区里的文件时间戳，这样make就能像本地一样识别出真正修改过的文件。

配置步骤： #

1. 在你的build job里添加Git策略变量，同时调整缓存key为分支/标签名（避免不同分支互相干扰）
2. 加上分支切换时的清理逻辑，防止跨分支的代码污染
3. 保留原有的build/bin缓存作为 fallback（比如当Runner工作区被回收时）

修改后的CI配置示例：

cache:
  key: "$CI_BUILD_REF_NAME"  # 按分支/标签独立缓存，避免分支间干扰
  paths:
    - bin/
    - build/
build:
  image: <my_build_image>
  stage: build
  variables:
    GIT_STRATEGY: fetch
    # GIT_DEPTH: 0  # 如果你的make依赖完整Git历史（比如生成版本号），取消注释这行
  before_script:
    # 检查是否切换了分支，是则清理工作区和旧构建产物
    - |
      if [ -f .previous_branch ]; then
        PREVIOUS_BRANCH=$(cat .previous_branch)
        if [ "$PREVIOUS_BRANCH" != "$CI_COMMIT_BRANCH" ]; then
          git reset --hard origin/$CI_COMMIT_BRANCH
          git clean -fd
          rm -rf build/ bin/
        fi
      fi
      echo "$CI_COMMIT_BRANCH" > .previous_branch
  script:
    - "make PLATFORM='x86_64-linux-gnu' BUILD='release' JOBS=8 all"
  only:
    - master
    - tags
    - merge-requests
  artifacts:
    untracked: true
    paths:
      - bin/x86_64-linux-gnu/release

效果： #

• 同分支下的后续Job：只会拉取最新代码变更，只有修改过的文件时间戳会更新，make自动增量构建，复用缓存的中间产物和二进制
• 分支切换时：自动清理工作区和旧构建产物，触发一次全量构建，保证分支代码纯净

方案2：Docker镜像缓存（适合大型项目） #

如果你的项目体量很大，或者需要长期保留构建上下文，可以把构建好的中间产物和工作区打包成Docker镜像，下次构建时基于这个镜像继续。

思路： #

1. 构建完成后，将当前工作区（包括src、build、bin）推送到私有镜像仓库
2. 下次构建时，用docker build --cache-from指定这个镜像作为基础，跳过已编译的部分

这种方式维护成本较高，需要你有自己的镜像仓库，但适合需要稳定长期缓存的大型项目。

方案3：调整Makefile忽略源码时间戳（不推荐） #

你可以修改Makefile，让make基于文件内容哈希而非时间戳判断是否需要重新编译，比如用hashdeep生成文件哈希，或者自定义依赖规则。但这种方式需要修改构建逻辑，容易引入bug，而且调试起来很麻烦，除非万不得已不建议用。

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