GitHub Actions流水线分支匹配条件步骤未按预期运行

步骤条件判断不生效是两个写法错误导致的：

• github.ref是GitHub Actions内置上下文变量，存储的是完整Git引用路径，不是纯分支短名。当前流水线运行在fix_bug分支时，该变量实际值为refs/heads/fix_bug，代码里相等判断的右值写的是纯字符串fix_bug，完全匹配不上。
• contains函数的搜索关键词写反了字符顺序：要匹配的分支名是fix_bug，代码里写的搜索值是bug_fix，无法命中匹配规则。
  两个判断条件全为false，步骤直接被跳过不执行。

优先用GitHub官方提供的短分支名变量github.ref_name，这个变量直接返回去掉引用前缀的纯分支名，不用手动拼接路径，写法更简洁不容易出错：

- name: Run Step
  if: ${{ contains(github.ref_name, 'fix_bug') || github.ref_name == 'fix_bug' }}
  run: |
    # 此处填写步骤实际要执行的命令

如果你的规则本来就是「所有分支名包含fix_bug的场景都执行步骤」，条件可以直接简化——精确等于fix_bug的场景本来就会被contains匹配到，不需要额外写或逻辑：

- name: Run Step
  if: ${{ contains(github.ref_name, 'fix_bug') }}
  run: |
    # 此处填写步骤实际要执行的命令

如果要沿用github.ref变量写判断，必须补全完整的引用路径前缀，同时把contains的搜索关键词顺序改对：

- name: Run Step
  if: ${{ contains(github.ref, 'fix_bug') || github.ref == 'refs/heads/fix_bug' }}
  run: |
    # 此处填写步骤实际要执行的命令

补充提示：如果流水线触发事件是拉取请求（pull_request），不要用上面两个变量判断源分支，这类场景下github.ref指向PR临时合并引用，github.ref_name返回PR编号，要取PR的源分支名需要用github.head_ref变量。

内容的提问来源于stack exchange，提问作者K.W