GitHub Action中能否用变量指定分支名？避免配置重复

GitHub Action的触发条件（on字段）属于工作流的静态配置阶段，这时候还无法引用运行时才初始化的env变量，所以你之前用${{ env.GITHUB_BRANCH }}会报错。下面提供两种可行的复用分支规则的方法：

方法1：用YAML锚点实现静态复用（最直接） #

利用YAML本身的锚点&别名语法，把分支规则定义成一个可复用的锚点，在push和pull_request的branches字段里直接引用：

name: CI Workflow

# 定义分支规则锚点
branches_to_monitor: &branches_list
  - main
  - develop
  - release/*

on:
  push:
    branches: *branches_list
  pull_request:
    branches: *branches_list

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      # 后续步骤需要分支名时，直接用GitHub内置变量即可
      - name: Print current branch
        run: |
          # 区分push和PR场景的分支名
          if [[ "${{ github.event_name }}" == "pull_request" ]]; then
            echo "PR source branch: ${{ github.head_ref }}"
          else
            echo "Pushed branch: ${{ github.ref_name }}"
          fi

修改分支规则时，只需要改动锚点&branches_list部分，两处触发配置会自动同步。

方法2：用可复用工作流（多工作流共享规则） #

如果需要在多个工作流里复用相同的分支触发逻辑，可以把触发规则抽成一个可复用工作流，主工作流调用它：

首先创建.github/workflows/reusable-trigger.yml：

name: Reusable Branch Trigger

on:
  push:
    branches:
      - main
      - develop
      - release/*
  pull_request:
    branches:
      - main
      - develop
      - release/*

jobs:
  get-branch:
    runs-on: ubuntu-latest
    outputs:
      target_branch: ${{ steps.extract_branch.outputs.branch }}
    steps:
      - id: extract_branch
        run: |
          if [[ "${{ github.event_name }}" == "pull_request" ]]; then
            echo "branch=${{ github.head_ref }}" >> "$GITHUB_OUTPUT"
          else
            echo "branch=${{ github.ref_name }}" >> "$GITHUB_OUTPUT"
          fi

然后在主工作流中调用这个模板：

name: Main CI Workflow

on:
  workflow_call:
    outputs:
      target_branch:
        type: string
        description: "The branch that triggered the workflow"

jobs:
  build:
    needs: get-branch
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Print reused branch name
        run: echo "Triggered by branch: ${{ needs.get-branch.outputs.target_branch }}"

这种方式适合团队内多个工作流共享相同的触发规则，后续修改只需要更新复用模板即可。

关键注意点 #

• 触发条件是静态配置，只能用YAML原生的复用语法，不能引用运行时变量（比如env、steps输出等）。
• 后续步骤需要分支名时，直接用GitHub提供的内置变量：
  • Push场景用${{ github.ref_name }}（分支短名）
  • PR场景用${{ github.head_ref }}（PR源分支）或${{ github.base_ref }}（PR目标分支）

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