GitHub Actions：如何用环境变量匹配分支后缀触发推送事件

问题根源 #

GitHub Actions的on触发条件（比如on.push.branches）是在工作流启动前就进行评估的，这个阶段无法访问工作流级别的env变量，也不能解析${{ env.XXX }}这类运行时表达式——因为这些变量和表达式要等到工作流正式开始运行后才会被加载解析。所以你直接写"**$PROJECT"或者"**${{ env.PROJECT }}"都不会生效，而硬编码后缀的方式是直接匹配字符串，所以能正常触发。

可行解决方案 #

方案1：使用仓库/组织变量（推荐） #

把项目名称配置成仓库级别的变量，这样触发阶段就能读取到这个变量：

1. 打开你的GitHub仓库，进入「Settings」→「Secrets and variables」→「Variables」
2. 新建一个变量，名称设为PROJECT，值填project-name
3. 修改workflow配置：

   on:
     push:
       branches:
         - "**${{ vars.PROJECT }}"
   

   这种方式和硬编码的效果一致，而且变量可以统一管理，方便修改。

方案2：允许全分支触发，在Job阶段做判断 #

如果不想用仓库变量，可以先让所有分支都触发工作流，然后在具体Job里判断分支名是否符合后缀要求，不符合就跳过：

env:
  PROJECT: project-name

on:
  push:
    branches:
      - "**" # 允许所有分支触发Push事件

jobs:
  your-job-name:
    runs-on: ubuntu-latest
    # 判断当前分支名是否以指定后缀结尾
    if: endsWith(github.ref_name, env.PROJECT)
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4
      # 后续执行步骤...

注意：这种方式会让所有分支的Push都触发工作流初始化，但不符合条件的Job会直接跳过，不会执行后续步骤，不会消耗额外的运行资源。

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