GitHub Actions复合动作中Bash脚本Git分支变量为空问题排查

1. 远程分支与标签未完整拉取 #

GitHub Actions 默认的 checkout 动作仅拉取最新的提交，不会同步所有远程分支和标签的元数据。git branch -r 依赖本地缓存的远程分支信息，没有完整拉取的话，自然无法识别目标分支和标签的关联关系。

• 修复方式：修改 checkout 步骤，拉取完整仓库并同步标签：

- name: 拉取完整仓库代码
  uses: actions/checkout@v4
  with:
    fetch-depth: 0
    fetch-tags: true

2. 标签变量格式或存在性异常 #

先确认 $tag_name 变量的正确性：

• 如果变量带 refs/tags/ 前缀，直接传入 git branch -r --contains 会匹配失败，需要先剥离前缀：

tag_name=$(echo "$tag_name" | sed 's/refs\/tags\///')

• 先执行 git tag -l "$tag_name" 验证标签是否存在，若返回空，说明标签未被拉取，回到第一个问题处理。

3. git branch -r --contains 的逻辑局限 #

这个命令仅返回直接包含标签对应提交的远程分支，如果标签是在其他分支创建后合并到 master，或者标签对应的提交未被 master 分支包含（比如打标签后 master 有新提交但标签未更新），就会返回空。

• 换用更可靠的检查方式：先获取标签对应的提交哈希，再判断 master 是否包含该提交：

# 获取标签对应的提交哈希
tag_commit=$(git rev-parse "$tag_name^{commit}")
# 检查master分支是否包含该提交
git merge-base --is-ancestor "$tag_commit" origin/master
# 根据返回码判断：0表示包含，1表示不包含
if [ $? -eq 0 ]; then
  echo "标签存在于master分支"
else
  echo "标签未在master分支中找到"
fi

4. 复合动作的变量传递问题 #

如果是在复合动作中调用脚本，要确认 tag_name 变量是否正确传递到脚本执行环境。比如在复合动作的 yaml 中，需通过 env 显式传递变量：

- name: 检查标签是否在master分支
  run: |
    tag_commit=$(git rev-parse "$TAG_NAME^{commit}")
    git merge-base --is-ancestor "$tag_commit" origin/master
  env:
    TAG_NAME: ${{ inputs.tag_name }}

内容的提问来源于stack exchange，提问作者J-Are