GitLab CI执行git命令报错：无法识别远程分支remotes/origin/turtles

我来帮你搞定这个GitLab CI里的分支识别问题！咱们先理清楚根源：GitLab Runner默认采用浅克隆策略，只会拉取仓库的最近少量提交，而且仅同步当前MR的目标分支（master）和源分支的最新快照，不会拉取所有远程分支的完整引用。这就是为什么你在本地和虚拟机上能正常执行命令，但Runner里找不到remotes/origin/turtles，甚至直接用turtles也不行的原因。

下面给你几个实用的解决方案：

方案1：禁用浅克隆，拉取完整仓库历史 #

在你的.gitlab-ci.yml里添加GIT_DEPTH: 0变量，让Runner拉取整个仓库的完整历史，这样所有远程分支的引用都会被同步到Runner环境中：

update-doc:
  only:
    - merge_requests
  variables:
    GIT_DEPTH: 0  # 禁用浅克隆，拉取完整仓库历史
  script:
    - echo "Source branch: $CI_MERGE_REQUEST_SOURCE_BRANCH_NAME"
    - git log master..$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME
    - git cherry master $CI_MERGE_REQUEST_SOURCE_BRANCH_NAME

这个方法的好处是一劳永逸，不需要修改脚本逻辑，但缺点是如果仓库很大，克隆时间会变长。

方案2：显式拉取源分支到本地 #

如果不想拉取完整历史（担心速度问题），可以在脚本开头先显式拉取源分支到Runner的本地仓库，这样就能直接使用分支名执行命令了：

update-doc:
  only:
    - merge_requests
  script:
    - echo "Source branch: $CI_MERGE_REQUEST_SOURCE_BRANCH_NAME"
    # 显式拉取远程源分支到本地同名分支
    - git fetch origin $CI_MERGE_REQUEST_SOURCE_BRANCH_NAME:$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME
    - git log master..$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME
    - git cherry master $CI_MERGE_REQUEST_SOURCE_BRANCH_NAME

这个方法更轻量化，只拉取你需要的分支历史，适合大型仓库。

方案3：利用MR的HEAD引用替代分支名 #

在GitLab MR的CI环境中，当前工作目录的HEAD其实就是源分支（turtles）的最新提交。所以你可以直接用HEAD代替分支名，不需要依赖远程分支引用：

update-doc:
  only:
    - merge_requests
  script:
    - echo "Source branch: $CI_MERGE_REQUEST_SOURCE_BRANCH_NAME"
    # 查看turtles相对于master的所有提交
    - git log master..HEAD
    # 检查哪些提交是turtles独有的
    - git cherry master HEAD

这个方法最简洁，不需要修改克隆策略或额外拉取操作，完全利用CI环境的默认状态就能实现需求。

不管用哪个方案，都能解决你当前的问题，让Runner正常识别分支并执行git log和git cherry命令。

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