GitHub Actions：如何基于拉取请求的源分支名称触发工作流

我完全理解你的感受——在job里加if判断虽然能解决问题，但确实不够优雅，和配置目标分支的简洁方式没法比。遗憾的是，GitHub Actions的pull_request触发器本身并没有提供像branches那样直接指定源分支的配置项（branches参数是专门用来匹配目标分支的），不过我们可以用一种更优雅的方式实现需求：在触发器层面添加条件过滤，而不是在job里做判断。

优雅解决方案：触发器层面的源分支过滤 #

你可以直接在on.pull_request配置中加入if条件，通过github.head_ref（这个变量对应PR的源分支，也就是箭头尾部的分支）来过滤触发条件。这样整个工作流只会在符合条件的源分支PR创建/同步/重开时启动，而不是先启动再跳过job，更高效也更简洁。

示例1：匹配特定源分支

如果只想在源分支是feature/my-specific-branch时触发工作流：

on:
  pull_request:
    types: [opened, synchronize, reopened]
    if: github.head_ref == 'feature/my-specific-branch'

示例2：匹配前缀的源分支

如果想匹配所有以feature/开头的源分支：

on:
  pull_request:
    types: [opened, synchronize, reopened]
    if: startsWith(github.head_ref, 'feature/')

示例3：正则匹配源分支

如果需要更灵活的匹配规则，可以用正则表达式：

on:
  pull_request:
    types: [opened, synchronize, reopened]
    if: matches('^feature/[0-9]+-', github.head_ref)

为什么这比job级判断更优雅？ #

• 更高效：不符合条件的PR不会触发任何工作流运行，避免了不必要的资源消耗和日志冗余。
• 更简洁：条件逻辑集中在触发器配置中，不用在每个job里重复写if判断，和配置目标分支的方式保持了一致的简洁性。
• 更清晰：从工作流配置的最顶端就能明确看到触发规则，可读性更强。

补充说明 #

目前GitHub Actions确实没有提供直接配置源分支的专属参数，所以这种触发器层面的条件判断是最接近你期望的优雅实现方式了。

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