GitHub Actions手动触发工作流如何实现动态名称配置

核心结论 #

你设想的直接在顶层工作流配置中写name: "Build and push ${{ github.event.inputs.tag }}"的方式完全不可行。
原因没有多余的设计考量：GitHub渲染Actions页面的工作流列表时，会直接读取YAML顶层的静态name字段做展示，这一阶段还没有触发具体的workflow_dispatch流程，根本不存在可读取的入参值。GitHub对顶层name字段的解析逻辑从设计上就不支持任何运行时表达式，写进去的表达式只会被当成普通字符串原样显示，严重时还会触发配置校验报错。

实际可落地的替代方案 #

方案1：通过Job级别的动态命名匹配展示需求 #

这是改造成本最低的实现方式，不需要额外增加前置步骤，只需要给核心构建Job配置带表达式的名称即可——Job级别的name字段不受顶层字段的解析限制，是完全支持运行时表达式解析的。
配置示例：

# 顶层保留基础静态名称，保证工作流能被正常索引识别
name: Build and push
on:
  workflow_dispatch:
    inputs:
      tag:
        description: 待构建推送的目标镜像标签
        required: true

jobs:
  build-and-push:
    # Job名称会在运行时自动解析表达式，替换为实际传入的tag值
    name: Build and push image - ${{ github.event.inputs.tag }}
    runs-on: ubuntu-latest
    steps:
      # 实际构建推送逻辑
      - uses: actions/checkout@v4
      # ... 其余登录镜像仓库、构建镜像、推送镜像的步骤

效果：手动触发完成后，在工作流运行详情页可以看到带具体tag值的动态Job名称，和预期的展示效果高度一致，仅工作流列表页会展示顶层配置的静态名称。

方案2：通过运行时设置全局运行名称，实现全链路动态展示 #

如果需要连工作流运行历史列表里的条目名称也带上动态tag，可以使用GitHub Actions原生支持的GITHUB_RUN_NAME环境变量，直接修改当前运行的全局展示名称。
配置示例：

name: Build and push
on:
  workflow_dispatch:
    inputs:
      tag:
        description: 待构建推送的目标镜像标签
        required: true

jobs:
  init-run-name:
    runs-on: ubuntu-latest
    steps:
      - name: 写入动态运行名称
        run: |
          echo "GITHUB_RUN_NAME=Build and push image - ${{ github.event.inputs.tag }}" >> "$GITHUB_ENV"

  build-and-push:
    needs: init-run-name
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      # ... 其余实际构建推送步骤

效果：环境变量写入后，不管是Actions模块的运行历史列表，还是单个运行页的头部标题，都会展示带具体tag值的动态名称，完全匹配你期望的动态展示效果，且不会影响工作流本身的配置校验。

常见踩坑提醒 #

• 不要尝试在顶层name字段嵌入任何上下文表达式，GitHub对该字段的解析逻辑完全不支持表达式渲染，写入的表达式只会被当成普通字符串处理。
• 写入GITHUB_RUN_NAME的步骤要尽量放在无依赖的最前置位置，减少动态名称的展示延迟。

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