本地Shell脚本可获分支名，GitHub Actions中返回HEAD的问题排查

GitHub Actions 默认使用的 actions/checkout 动作会以浅克隆（fetch-depth: 1）+ 分离 HEAD 状态拉取代码：

• 浅克隆仅获取当前提交的快照，不会拉取完整的分支引用信息
• 分离 HEAD 意味着当前工作区直接指向某个提交哈希，而非关联到本地分支，此时执行git rev-parse --abbrev-ref HEAD会返回HEAD，而非实际分支名

以下几种方案均可在你的 Shell 脚本中直接执行，获取 PR 的源分支名：

方案1：通过提交关联的远程分支提取 #

利用git for-each-ref查找包含当前 HEAD 提交的远程分支，再提取分支名：

BRANCH_NAME=$(git for-each-ref --format='%(refname:short)' --contains HEAD refs/remotes/origin/ | grep -v HEAD | head -n1)
echo $BRANCH_NAME

方案2：先拉取完整分支信息再获取上游分支 #

先拉取所有远程分支引用，再通过上游分支关联获取分支名：

# 拉取所有远程分支信息
git fetch --all --quiet
# 获取当前提交对应的上游分支名，去除origin/前缀
BRANCH_NAME=$(git rev-parse --abbrev-ref HEAD@{upstream} | sed 's/origin\///')
echo $BRANCH_NAME

方案3：通过分支包含关系筛选 #

用git branch -a列出所有包含当前提交的分支，过滤后提取：

BRANCH_NAME=$(git branch -a --contains HEAD | grep -v HEAD | sed 's/.*origin\///' | head -n1)
echo $BRANCH_NAME

额外参考（调整 workflow 配置辅助） #

如果允许修改 workflow 的 checkout 配置（仅调整拉取方式，不直接使用分支变量），可以在 checkout 时指定拉取完整分支并切换到对应分支，这样你的原脚本就能正常工作：

- uses: actions/checkout@v4
  with:
    ref: ${{ github.head_ref }}
    fetch-depth: 0

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