如何在GitHub Actions中为checkout设置条件式ref？

不用非得拆分多个条件执行步骤，你可以直接在actions/checkout的ref参数里用GitHub Actions的表达式语法，一次性实现你要的多优先级分支选择逻辑，这种方式更简洁高效。

直接在checkout步骤中实现 #

- name: 拉取meta仓库
  uses: actions/checkout@v4
  with:
    repository: <你的meta仓库地址>
    ref: ${{ github.event.client_payload.ref || (github.ref_name == 'main' && 'main') || 'dev' }}

逻辑拆解 #

• 优先级最高：如果github.event.client_payload.ref有值，直接用这个分支；
• 次之：如果没有传参，且当前工作流运行的分支是main，就拉取meta仓库的main分支；
• 默认：前两个条件都不满足时，拉取dev分支。

可选：用环境变量提升可读性 #

如果你觉得表达式太长不好维护，也可以提前用环境变量定义好目标分支，再在checkout步骤中引用：

env:
  META_TARGET_BRANCH: ${{ github.event.client_payload.ref || (github.ref_name == 'main' && 'main') || 'dev' }}

- name: 拉取meta仓库
  uses: actions/checkout@v4
  with:
    repository: <你的meta仓库地址>
    ref: ${{ env.META_TARGET_BRANCH }}

当然，你提到的条件执行整个步骤的方式也能实现，就是拆分成三个checkout步骤，每个步骤对应一个触发条件，但这种方式代码冗余，不如上面的表达式写法简洁。示例如下：

- name: 拉取meta仓库（传参分支）
  if: ${{ github.event.client_payload.ref }}
  uses: actions/checkout@v4
  with:
    repository: <你的meta仓库地址>
    ref: ${{ github.event.client_payload.ref }}

- name: 拉取meta仓库（main分支）
  if: ${{ !github.event.client_payload.ref && github.ref_name == 'main' }}
  uses: actions/checkout@v4
  with:
    repository: <你的meta仓库地址>
    ref: main

- name: 拉取meta仓库（dev分支）
  if: ${{ !github.event.client_payload.ref && github.ref_name != 'main' }}
  uses: actions/checkout@v4
  with:
    repository: <你的meta仓库地址>
    ref: dev

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