如何避免GitLab流水线各阶段间CMake重复构建？

首选方案：用GitLab缓存替代制品传递 #

GitLab缓存比制品更适合保留构建目录的完整结构，避免归档/解压导致的路径变更问题：

• 在.gitlab-ci.yml中为所有相关阶段配置统一缓存：

  cache:
    key: "$CI_COMMIT_REF_SLUG-build-cache"
    paths:
      - build/  # 固定CMake构建目录，所有阶段复用此路径
    policy: pull-push  # 构建阶段推送缓存，测试/分析阶段拉取缓存
  

• 所有阶段的CMake命令都使用相对路径./build作为构建目录，确保缓存恢复后能直接复用已有构建产物。

修复ExternalProject的绝对路径依赖 #

CMake ExternalProject默认生成绝对路径的缓存，可通过以下方式修改配置，增强可重定位性：

• 在顶层CMakeLists.txt中为ExternalProject指定相对路径参数：

  ExternalProject_Add(
    my_internal_dep
    SOURCE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/deps/my_dep"
    BINARY_DIR "${CMAKE_CURRENT_BINARY_DIR}/deps/my_dep-build"
    INSTALL_DIR "${CMAKE_CURRENT_BINARY_DIR}/deps/my_dep-install"
    CMAKE_ARGS
      -DCMAKE_INSTALL_PREFIX=<INSTALL_DIR>
      -DCMAKE_BUILD_TYPE=${CMAKE_BUILD_TYPE}
      -DCMAKE_MAKE_PROGRAM=${CMAKE_MAKE_PROGRAM}
      # 强制生成相对路径的构建文件（CMake 3.0+虽标记过时，但仍生效）
      -DCMAKE_USE_RELATIVE_PATHS=ON
  )
  

缓存恢复后自动修正路径 #

如果上述方法无效，可在测试/代码分析阶段添加脚本，批量替换ExternalProject缓存中的旧绝对路径：

• 在.gitlab-ci.yml的对应阶段添加前置脚本：

  test:
    stage: test
    before_script:
      - |
        # 提取旧构建路径并替换为当前路径
        OLD_PATH=$(grep -r "CMAKE_BINARY_DIR:PATH" build/*/CMakeCache.txt | head -n1 | cut -d'=' -f2)
        NEW_PATH="${CI_PROJECT_DIR}/build"
        if [ -n "$OLD_PATH" ] && [ "$OLD_PATH" != "$NEW_PATH" ]; then
          grep -rl "$OLD_PATH" build/ | xargs sed -i "s|$OLD_PATH|$NEW_PATH|g"
        fi
    script:
      - cd build && ctest
  

拆分依赖构建为独立阶段 #

若依赖变更频率低，可将依赖构建单独拆分，上传为制品供后续阶段复用：

• 新增build_deps阶段：

  build_deps:
    stage: build_deps
    script:
      - mkdir -p deps-build
      - cd deps-build
      - cmake ../ -DBUILD_DEPS_ONLY=ON  # 需在CMake中添加此开关，仅构建依赖
      - make -j$(nproc)
    artifacts:
      paths:
        - deps-build/deps-install/
      expire_in: 1 week
  

• 主构建阶段指定预构建依赖路径：

  build:
    stage: build
    needs: ["build_deps"]
    script:
      - mkdir -p build
      - cd build
      - cmake ../ -DDEP_INSTALL_PREFIX=${CI_PROJECT_DIR}/deps-build/deps-install
      - make -j$(nproc)
  

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