如何配置GitHub Action在手动构建名称中显示对应分支名

核心实现逻辑 #

GitHub Actions 支持在工作流根级名称字段中直接引用运行时上下文变量，无需额外执行脚本、引入第三方插件，即可将原来硬编码的固定值（比如写死的"ONE"）替换为实际的触发分支名。

具体修改操作 #

• 定位工作流 YAML 文件中硬编码构建名的位置：一般在文件最顶部的name字段，类似name: Build ONE的固定写法，是导致构建名称不随分支动态变化的核心原因
• 将硬编码的固定值替换为github.ref_name上下文变量：该变量在手动触发场景下，会直接返回当前选中的触发分支/标签的纯名称，无多余路径前缀，展示效果直观
• 替换参考示例：
  原始硬编码写法：

  name: Build ONE
  on:
    workflow_dispatch:
  

  修改后的动态写法：

  name: Build ${{ github.ref_name }}
  on:
    workflow_dispatch:
  

适配说明 #

• 若原有构建名是固定前缀加后缀的组合结构，比如原配置为name: Build ONE [Release]，仅需将中间的固定值替换为变量即可，对应修改为name: Build ${{ github.ref_name }} [Release]，运行时会自动生成类似Build feature/login [Release]的展示效果
• 避免误用github.ref变量：该变量返回带全路径的引用值，比如refs/heads/main，直接嵌入名称会导致展示内容冗长
• 修改完成后重新手动触发一次工作流，即可在运行列表的构建名称位置看到动态替换后的分支名，无需调整其他触发规则

内容的提问来源于stack exchange，提问作者Zhivko.Kostadinov