GitHub Action：兼容workflow_dispatch变量与作业输出赋值环境变量

核心思路是通过GitHub Actions的事件名称判断触发类型，分别从PR触发的步骤输出或workflow_dispatch的手动输入中取值，同时添加兜底逻辑避免空值。

1. 配置触发方式与手动输入参数 #

首先在workflow开头定义两种触发方式，并为workflow_dispatch设置必填的自定义输入：

on:
  pull_request:
    branches: [main]
  workflow_dispatch:
    inputs:
      custom_value:
        description: '手动输入的自定义值'
        required: true
        type: string

2. PR触发时生成步骤输出 #

在作业中添加仅PR触发时执行的步骤，生成后续需要的输出值：

jobs:
  prepare:
    runs-on: ubuntu-latest
    outputs:
      pr_generated_value: ${{ steps.gen_pr_value.outputs.result }}
    steps:
      - name: 生成PR专属值
        id: gen_pr_value
        if: github.event_name == 'pull_request'
        run: |
          # 这里替换成实际生成值的逻辑，比如从PR信息提取、脚本生成等
          echo "result=pr-auto-generated-value" >> $GITHUB_OUTPUT

3. 统一赋值变量 #

在后续作业或步骤中，通过表达式判断触发来源，统一赋值到同一个变量，同时添加兜底处理：

process:
    needs: prepare
    runs-on: ubuntu-latest
    steps:
      - name: 统一获取变量并设置到环境
        run: |
          # 根据触发类型选择对应值，兜底使用默认值避免空值
          UNIFIED_VALUE="${{ 
            github.event_name == 'pull_request' 
            && needs.prepare.outputs.pr_generated_value 
            || github.event.inputs.custom_value 
            || 'default-value' 
          }}"
          echo "统一变量值: $UNIFIED_VALUE"
          echo "UNIFIED_VALUE=$UNIFIED_VALUE" >> $GITHUB_ENV

      - name: 使用统一变量
        run: |
          # 后续步骤直接使用$UNIFIED_VALUE即可
          echo "正在使用统一变量: $UNIFIED_VALUE"

关键注意事项 #

• 确保workflow_dispatch的custom_value设置为required: true，强制用户输入，减少空值概率
• PR触发的生成步骤添加if: github.event_name == 'pull_request'，避免workflow_dispatch触发时执行无用步骤
• 兜底值可根据业务需求调整，比如设为空字符串或特定默认值
• 如果变量不需要跨job传递，直接在同一个job内使用步骤输出即可，无需needs关联

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