GitLab CI作业切换Git分支异常问题求助

环境背景 #

• 构建环境：GitLab-CI（Ubuntu系统）
• Git版本：2.25.1（受发行版限制无法升级）
• 特殊限制：gitlab-runner工作目录与被测代码目录不一致，需手动切换目标目录至指定Git分支

问题回顾 #

1. 初始脚本使用git pull <repo> $BRANCH仅拉取分支文件，但未切换分支，git status仍显示在master分支
2. 修改后脚本尝试先pull再git checkout $BRANCH，报错error: pathspec '<branch name>' did not match any file(s) known to git，且git reset --hard origin/master是重置到本地缓存的旧master状态，而非远程最新版本

修正后的完整脚本 #

script:
  - cd <target-directory>
  # 彻底清理工作区，包括.gitignore忽略的文件
  - git clean -d -f -x .
  # 更新远程仓库所有分支信息，并清理本地失效的远程分支引用
  - git fetch --prune https://bot.bcs_git:$BOT_SSO@<my-repository>.git
  # 重置到远程最新的master分支（避免使用本地缓存的origin/master）
  - git reset --hard FETCH_HEAD:master
  # 创建本地分支并追踪远程指定分支，完成切换
  - git checkout -b $BRANCH --track https://bot.bcs_git:$BOT_SSO@<my-repository>.git/$BRANCH
  # 验证分支状态
  - git status

关键命令解释 #

• git clean -d -f -x .：新增-x参数，确保清除所有未跟踪文件（包括被.gitignore忽略的），彻底重置工作区状态，避免残留文件干扰后续操作
• git fetch --prune <repo-url>：--prune会删除本地已不存在的远程分支引用，同时强制拉取所有远程分支的最新元数据，解决origin/master为本地旧缓存的问题
• git reset --hard FETCH_HEAD:master：直接使用刚fetch到的远程master分支的FETCH_HEAD进行重置，确保工作区与远程最新master完全一致
• git checkout -b $BRANCH --track <repo-url>/$BRANCH：由于本地未创建对应分支的引用，通过-b创建本地分支并直接绑定远程分支的追踪关系，避免pathspec匹配失败的错误

Git 2.25.1版本适配说明 #

• 该版本的git pull在指定远程分支时不会自动切换本地分支，必须通过fetch + checkout的组合完成分支切换
• 避免直接依赖origin/<branch>引用，需先执行fetch确保远程引用为最新状态

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