如何在GitLab CI中获取当前分支自创建以来的变更文件列表？

核心问题分析 #

GitLab CI 默认采用浅克隆（仅拉取最近少量提交），导致本地无法获取完整分支历史，这就是你之前的本地命令在CI环境中只能拿到最近两次提交的原因。要获取分支自创建以来的变更，关键是找到分支的基准提交（即分支从父分支/提交切出的起点），再对比基准提交与当前提交的差异。

具体实现方案 #

方案1：基于默认分支的基准提交（推荐） #

如果你的分支从项目默认分支（如main/master）创建，可按以下步骤操作：

1. 在CI Job中拉取默认分支的完整历史：

   git fetch origin main:main
   

2. 找到当前分支与默认分支的最近公共祖先（即分支创建时的基准提交）：

   BASE_SHA=$(git merge-base HEAD main)
   

3. 对比基准提交与当前提交的变更文件列表：

   git diff --name-only $BASE_SHA $CI_COMMIT_SHA
   

方案2：完整克隆仓库（适合基准不明确的场景） #

如果分支可能从任意提交切出且无法确定基准分支，可让GitLab CI做完整克隆：

1. 在.gitlab-ci.yml中设置克隆深度为0（完整克隆）：

   variables:
     GIT_DEPTH: 0
   

2. 获取分支创建时的基准提交：

   # 获取分支第一个提交的父SHA（即分支切出的起点）
   BASE_SHA=$(git log --reverse --pretty=%P HEAD | head -n1)
   

   若分支为独立创建（无父提交），则直接对比分支首个提交与当前提交：

   FIRST_COMMIT_SHA=$(git rev-list --reverse HEAD | head -n1)
   git diff --name-only $FIRST_COMMIT_SHA $CI_COMMIT_SHA
   

方案3：合并请求场景专属 #

如果流水线由**合并请求（MR）**触发，GitLab CI会自动提供相关变量，可直接对比源分支与目标分支的差异：

git fetch origin $CI_MERGE_REQUEST_TARGET_BRANCH_NAME
git diff --name-only origin/$CI_MERGE_REQUEST_TARGET_BRANCH_NAME $CI_MERGE_REQUEST_SOURCE_BRANCH_SHA

注意事项 #

• 方案1和3无需完整克隆，执行速度更快，优先推荐；
• 完整克隆（方案2）会拉取整个仓库历史，适合复杂分支场景，但会增加CI执行时长；
• 拿到变更文件列表后，可编写Shell/Python脚本匹配受影响服务，再触发对应测试任务。

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