GitHub Action中‘undefined Git ref’含义及触发问题咨询

文档术语解释 #

If you define only tags/tags-ignore or only branches/branches-ignore, the workflow won't run for events affecting the undefined Git ref

• undefined Git ref：指你在触发配置里没明确指定的Git引用类型。比如你只配置了tags相关规则，那分支（branch）就是“未定义的Git引用”；反之如果只配了分支规则，标签就是未定义的。
• events affecting the undefined Git ref：指作用于未定义引用类型的事件。比如你只配了标签触发，那推送分支代码、删除分支这类针对分支的push操作，就属于这类事件，此时工作流不会触发。

你的触发配置分析 #

你的配置逻辑完全符合需求，只会在推送vX.X.X格式的标签时触发工作流：

on:
  push:
    tags:
      - "v[0-9]+.[0-9]+.[0-9]+"

两个工作流无法运行的排查方向 #

• 核对推送的标签格式：有没有推了v3.1（缺一位版本号）、V3.1.0（大写V）这类不符合正则的标签，导致触发条件不匹配
• 检查工作流文件状态：确保这两个文件放在仓库的.github/workflows/目录下，后缀是.yml或.yaml
• 确认工作流权限：在仓库「Settings → Actions → General」里，查看“Workflow permissions”是否允许工作流读取仓库内容并运行
• 排查语法错误：打开工作流文件，GitHub会自动标注语法问题，比如正则表达式有没有写错、符号是否遗漏
• 查看运行历史：在仓库「Actions」页面找到这两个工作流，看是否有被跳过的记录，跳过原因会明确标注（比如标签不匹配、权限不足等）

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