如何判断Git分支是否为新建分支？含GitLab CI验证需求

没问题，我来帮你梳理几种可行的方案，不管是本地验证分支状态，还是在GitLab CI里实现自动化检查都能搞定：

如果是在本地仓库里验证，核心思路就是对比当前分支和它的父分支（比如master/main）的提交差异：

• 方法1：统计分支间的提交差异数
  假设你的分支是从master切出来的，直接用这条命令就能统计当前分支比master多的提交数量：

  git rev-list --count master..HEAD
  

  如果返回结果是0，说明这个分支完全没有新提交，就是刚创建的状态；如果返回大于0的数字，就是有提交记录。
  要是你不确定父分支是什么，也可以先找到当前分支与默认分支的共同祖先，再统计差异：

  # 先找到共同祖先的提交ID
  COMMON_ANCESTOR=$(git merge-base master HEAD)
  # 统计当前分支相对于祖先的提交数
  git rev-list --count $COMMON_ANCESTOR..HEAD
  

• 方法2：检查分支的提交历史长度（仅作辅助）
  刚创建的分支还没提交时，它的提交数和父分支完全一致，你可以用这条命令对比：

  [ $(git rev-list --count HEAD) -eq $(git rev-list --count master) ] && echo "无新提交" || echo "有新提交"
  

  不过这个方法有局限性——如果父分支在你切分支后也有新提交，结果就不准了，所以更推荐用方法1。

GitLab CI没有直接提供判断分支是否有新提交的预定义变量，但我们可以利用CI自带的变量（比如CI_COMMIT_BRANCH、CI_DEFAULT_BRANCH）结合Git命令来实现：

1. 核心脚本思路 #

在.gitlab-ci.yml里添加一个专门的检查Job，核心步骤是：

• 拉取默认分支的最新提交（因为CI环境默认是浅克隆，需要确保有足够的历史）
• 统计当前分支与默认分支的提交差异数
• 根据差异数判断分支状态，执行对应的逻辑（比如阻止无提交的分支通过CI）

2. 完整CI配置示例 #

check-new-branch:
  stage: verify
  script:
    # 解决浅克隆导致的历史不足问题，拉取完整的默认分支历史
    - git fetch --unshallow origin $CI_DEFAULT_BRANCH || git fetch origin $CI_DEFAULT_BRANCH
    # 统计当前分支比默认分支多的提交数
    - COMMIT_COUNT=$(git rev-list --count origin/$CI_DEFAULT_BRANCH..$CI_COMMIT_BRANCH)
    - |
      if [ $COMMIT_COUNT -eq 0 ]; then
        echo "⚠️  当前分支为新建分支，无任何提交记录！"
        # 如果你想阻止这类分支通过CI，就添加exit 1
        # exit 1
      else
        echo "✅  当前分支有 $COMMIT_COUNT 个新提交"
      fi
  only:
    - branches
  except:
    - $CI_DEFAULT_BRANCH # 排除默认分支本身

3. 注意事项 #

• 浅克隆问题：GitLab CI默认只拉取最近1次提交（浅克隆），所以必须用git fetch --unshallow或者git fetch origin $CI_DEFAULT_BRANCH来获取足够的历史，否则git rev-list可能找不到分支间的共同祖先，导致统计出错。
• 非默认父分支的情况：如果你的分支是从其他非默认分支切出来的，可以把$CI_DEFAULT_BRANCH替换成对应的父分支名称，或者新增一个CI变量让用户指定父分支。

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