在GitHub Actions中检测当前提交标签的问题

核心原因 #

1. 标签未推送到远程仓库：git push默认只会推送当前分支（master）的提交，你本地创建的0.9.5.0标签并没有同步到远程仓库，因此触发的工作流是分支推送事件，上下文自然指向master分支。
2. 工作流触发条件未监听标签推送：如果你的工作流仅配置了监听分支的push事件，即便后续推送标签，之前分支推送触发的工作流也不会切换到标签上下文。

解决方法 #

1. 推送标签到远程 #

执行以下命令将本地标签推送到远程（因使用了-f强制更新标签，推送时需加--force）：

git push origin --force 0.9.5.0

若为首次创建标签无需强制，直接执行git push origin 0.9.5.0即可。

2. 调整工作流触发条件 #

修改工作流配置文件（如.github/workflows/xxx.yml），添加标签推送的监听规则，确保标签推送能触发工作流，同时保留分支推送监听：

on:
  push:
    branches:
      - master
    tags:
      - '0.*'  # 匹配你的标签格式，适配0.x.x.x类标签规则

推送标签时，工作流会以标签上下文运行，此时echo $GITHUB_REF会返回refs/tags/0.9.5.0，github.ref_name会返回0.9.5.0。

3. 分支推送时获取关联标签（可选） #

若需在分支推送的工作流中获取当前提交对应的标签，确保标签已关联到该提交并推送到远程后，可在工作流中执行以下命令查询：

git describe --tags --abbrev=0

该命令会输出当前提交对应的最近标签（需保证工作流执行时拉取了完整的标签信息）。

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