GitHub Action显示名称与工作流文件中name字段定义不匹配问题咨询

问题根因 #

该工作流展示名称与name字段定义不一致的问题，确实是由工作流内直接执行git push --tags的调整导致，核心原因如下：

• 默认情况下，GitHub Actions 内置的 GITHUB_TOKEN 执行的标签推送操作，触发工作流时会跳过部分元数据解析步骤，不会读取工作流文件头部的name字段，而是直接 fallback 到工作流文件的文件名作为展示名称
• 此前用独立仓库Python脚本推送标签时，使用的是个人访问令牌（PAT）而非内置GITHUB_TOKEN，推送身份属于普通用户，触发工作流时会完整解析工作流的name字段，因此展示正常

解决方案 #

有两种可落地的修复方案：

方案1：使用个人访问令牌（PAT）执行标签推送 #

1. 生成具有仓库读写权限的PAT，将其配置为主仓库的Secret，可命名为PUSH_TAG_PAT
2. 把工作流中执行git push --tags步骤的仓库鉴权方式，从默认GITHUB_TOKEN替换为你创建的PAT，示例配置如下：

- name: 推送标签
  run: |
    git config user.name "配置的提交用户名"
    git config user.email "配置的提交邮箱"
    git tag 符合触发规则的标签名
    git push https://${{ secrets.PUSH_TAG_PAT }}@github.com/仓库所属用户名/仓库名.git --tags

方案2：手动指定触发工作流的展示名称 #

如果不想额外维护PAT，也可以在被标签触发的工作流头部添加run-name字段，强制指定运行时的展示名称，示例配置如下：

name: 你的原始工作流名称
run-name: 你的原始工作流名称 # 新增该字段即可强制指定展示名
on:
  push:
    tags:
      - '你配置的标签匹配规则'

两种方案都可以让工作流展示名称和你定义的内容保持一致，优先推荐方案1，不会影响其他工作流的触发逻辑。

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