GitHub Actions工作流疑难咨询：PR触发重复构建、分支名提取及任务执行控制

我来帮你逐个搞定这三个GitHub Actions的配置问题，每个问题都有针对性的解决方案和完整代码示例：

1. 避免push和pull_request事件重复触发构建 #

当你向已关联PR的分支推送代码时，GitHub会同时触发push和pull_request两个事件，导致两次重复构建。解决思路是通过条件判断，跳过其中一次无效触发。

GitHub在处理关联PR的push事件时，会自动带上github.event.pull_request字段。我们可以利用这个特性，给任务添加条件：仅在无PR关联的push事件或者pull_request事件时执行构建：

if: github.event_name == 'pull_request' || (github.event_name == 'push' && !github.event.pull_request)

2. 在PR触发的构建中正确获取源分支名称 #

PR触发的构建里，GITHUB_REF指向的是临时合并分支（格式为refs/pull/<PR号>/merge），不是你的实际源分支。要获取PR的源分支，得从github.event.pull_request.head.ref字段提取；而push事件中，直接从GITHUB_REF截取分支名即可。

另外注意：GitHub已经弃用了##[set-output]命令，现在推荐用GITHUB_OUTPUT环境变量传递步骤输出。修改后的分支提取步骤如下：

- name: Extract branch name
  shell: bash
  run: |
    # 根据事件类型选择分支来源
    if [[ "${{ github.event_name }}" == "pull_request" ]]; then
      BRANCH_NAME="${{ github.event.pull_request.head.ref }}"
    else
      BRANCH_NAME="${GITHUB_REF#refs/heads/}"
    fi
    # 替换分支名中的斜杠为横杠
    BRANCH_NAME=$(echo "$BRANCH_NAME" | sed 's/\//-/g')
    # 将结果写入步骤输出
    echo "branch=$BRANCH_NAME" >> "$GITHUB_OUTPUT"
  id: extract_branch

3. 让test任务仅在PR构建时运行 #

要实现push事件只执行check-environment，PR事件同时执行两个任务，只需要给test任务加个简单的条件判断：仅当事件类型为pull_request时运行。因为你的pull_request事件已经包含了opened、synchronize、reopened三种触发场景，这个条件会自动覆盖所有PR相关的构建：

test:
  runs-on: ubuntu-latest
  needs: check-environment
  # 仅在PR事件触发时执行
  if: github.event_name == 'pull_request'
  steps:
    - name: Echo branch name
      run: echo ${{ steps.extract_branch.outputs.branch }}

完整的工作流配置 #

整合以上所有修改后的完整代码：

name: APP Build
on:
  pull_request:
    types: [opened, synchronize, reopened]
  push:
    branches:
      - feature/test
jobs:
  check-environment:
    runs-on: ubuntu-latest
    # 避免重复触发的条件
    if: github.event_name == 'pull_request' || (github.event_name == 'push' && !github.event.pull_request)
    steps:
      - name: Extract branch name
        shell: bash
        run: |
          if [[ "${{ github.event_name }}" == "pull_request" ]]; then
            BRANCH_NAME="${{ github.event.pull_request.head.ref }}"
          else
            BRANCH_NAME="${GITHUB_REF#refs/heads/}"
          fi
          BRANCH_NAME=$(echo "$BRANCH_NAME" | sed 's/\//-/g')
          echo "branch=$BRANCH_NAME" >> "$GITHUB_OUTPUT"
        id: extract_branch
      # 可在此添加其他环境检查步骤
  test:
    runs-on: ubuntu-latest
    needs: check-environment
    # 仅PR事件触发时运行
    if: github.event_name == 'pull_request'
    steps:
      - name: Echo branch name
        run: echo ${{ steps.extract_branch.outputs.branch }}
      # 可在此添加你的测试步骤

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