GitHub Actions中Git标签条件不生效：action-gh-release发布任务被跳过

首先可以明确：你贴出的release job本身的配置（包括softprops/action-gh-release的引用、文件路径匹配、GITHUB_TOKEN的配置）是完全正确的，问题基本都出在工作流触发规则、标签同步的环节。

90%的情况：漏配工作流顶层的标签触发规则 #

你贴出的yml片段开头是省略的...，绝大多数遇到“推了标签但完全看不到对应工作流运行”的情况，都是只在job层级写了标签判断的if条件，完全没在工作流顶层声明要监听标签推送事件。
很多人会误以为只要if判断是针对标签的，推标签时GitHub就会自动跑对应流程——实际上GitHub Actions的触发逻辑是：只有顶层on配置匹配到对应事件时，才会启动一次工作流运行，job里的if判断只是在已经启动的运行里决定要不要跑某个job，根本不会反向触发工作流。
你需要在工作流最顶部补上对应的标签触发配置，示例：

on:
  push:
    tags:
      - 'v*'

如果之前只配置了分支推送的触发规则，哪怕标签是从已有的分支commit打的，推标签时也不会单独触发新的工作流运行，自然看不到对应标签的构建记录。

不需要换IDE：先确认标签有没有真的推到远端 #

IntelliJ自带的标签创建、推送功能完全正常，根本不需要换其他IDE，多数情况是你在IntelliJ的操作只完成了本地创建：

• IntelliJ推送标签时，需要在推送窗口主动勾选「Push tags」选项，否则打在本地的标签根本不会同步到GitHub远端
• 可以在本地仓库执行git ls-remote --tags命令，直接核对GitHub远端实际存在的标签列表，和本地创建的标签做对比，就能确认标签是不是真的推上去了

别搞混if条件的触发场景 #

如果你能看到分支推送触发的工作流运行（也就是之前assemble步骤成功的那次记录），但release job被标记为跳过，这是完全符合预期的逻辑：

• 因为那次工作流是分支推送触发的，运行时的github.ref实际值是refs/heads/你的分支名，根本不满足startsWith(github.ref, 'refs/tags/v')的判断条件，所以job会被跳过，这和标签本身的推送流程没关系
• 只有当标签推送事件真正触发新的工作流运行时，github.ref才会是refs/tags/vx.x.x的格式，这时候release job才会正常执行

最后容易漏的细节核对 #

• 确认你推送的v开头标签，指向的commit版本里已经包含了当前这份完整的yml配置：如果标签是很早之前打在旧commit上的，哪怕你后续在主分支加了release job的配置，推这个旧标签时也读不到对应的配置，自然不会触发发布流程
• 检查有没有把全局跳过的if判断写错位置，把标签触发的运行也过滤掉了

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