如何在非默认分支触发GitHub Workflow且避免配置重复？

核心原因 #

GitHub Actions 针对 pull_request 事件时，会从PR的目标分支读取工作流配置。由于你的 int 和 prod 分支没有存放工作流文件，所以针对这两个分支的PR不会触发任何检查。

下面是两种无需重复维护完整工作流的解决方法：

方法一：使用可复用工作流（推荐，无安全风险） #

将核心检查逻辑放在dev分支的可复用工作流中，int和prod分支仅添加极简的调用文件（几乎无需维护）。

1. 在dev分支创建可复用工作流
   创建.github/workflows/reusable-config-check.yaml，存放所有检查逻辑：

name: 可复用配置检查
on:
  workflow_call:
    # 可选：如果需要传递参数可以在这里定义

jobs:
  validate-config:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      # 这里添加你原来的检查步骤，比如验证JSON格式
      - name: 检查配置文件格式
        run: |
          jq . some-config-to-be-tested.json || exit 1

2. 更新dev分支的原工作流
   修改.github/workflows/check.yaml，改为调用可复用工作流：

on: 
  workflow_dispatch:
  pull_request:
    branches:
      - dev
      - int
      - prod
    paths:
      - '**/some-config-to-be-tested.json' 

jobs:
  run-check:
    uses: ./.github/workflows/reusable-config-check.yaml

3. 在int和prod分支添加调用文件
   分别在int和prod分支创建.github/workflows/check.yaml，内容仅需调用dev分支的可复用工作流：

on: 
  workflow_dispatch:
  pull_request:
    branches:
      - int # prod分支这里替换为-prod
    paths:
      - '**/some-config-to-be-tested.json' 

jobs:
  run-check:
    uses: <你的GitHub用户名>/<仓库名>/.github/workflows/reusable-config-check.yaml@dev

这样所有核心逻辑都在dev分支维护，int和prod的工作流文件仅作为调用入口，几乎不需要修改。

方法二：使用pull_request_target事件（适合静态检查，注意安全） #

利用pull_request_target事件特性：该事件会从**PR的基础分支（即你的dev分支）**读取工作流配置，无需在int/prod分支存放工作流。

1. 修改dev分支的工作流触发条件
   将原pull_request替换为pull_request_target，并添加代码 checkout 逻辑：

on: 
  workflow_dispatch:
    inputs:
      target_branch:
        description: '要检查的分支'
        required: true
        default: 'dev'
  pull_request_target:
    branches:
      - dev
      - int
      - prod
    paths:
      - '**/some-config-to-be-tested.json' 

jobs:
  check-config:
    runs-on: ubuntu-latest
    steps:
      # 因为pull_request_target默认checkout目标分支代码，这里需要切换到PR的代码
      - name: 拉取PR代码
        uses: actions/checkout@v4
        with:
          ref: ${{ github.event.pull_request.head.sha || github.event.inputs.target_branch }}
          persist-credentials: false # 避免权限问题
      # 原来的检查步骤
      - name: 验证配置文件
        run: |
          jq . some-config-to-be-tested.json || exit 1

注意事项

• pull_request_target 使用目标分支的权限运行，如果你的工作流需要执行PR中的脚本或未知代码，可能存在安全风险，仅建议用于静态检查场景。
• 手动触发时，可在dev分支的工作流页面指定要检查的分支（比如int或feature分支），无需在其他分支存放工作流。

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