如何在GitHub Actions中传递动态生成的输出至调用工作流？

直接通过${{ steps.retrieve-values.outputs.dynamic_name }}形式访问动态输出不可行，因为GitHub Actions的复合Action要求所有输出必须在action.yml的outputs字段中显式预先声明。动态添加到GITHUB_OUTPUT的未声明键，在调用工作流中无法被识别，解析时会出现"输出未定义"的错误，或无法获取对应值。

以下是几种可行的替代方案：

替代方案1：预先枚举所有可能的输出键（适用于已知固定候选值场景） #

如果names输入的可能值是可提前枚举的，直接在action.yml中声明对应输出：

inputs:
  names:
    description: Names to be retrieved

outputs:
  foo:
    description: Value for foo
  bar:
    description: Value for bar
  # 按需添加所有可能的名称对应的输出

runs:
  using: 'composite'
  steps:
    - id: retrieve-values
      shell: bash
      run: |
        set -euxo pipefail
        clean_params=$(echo "${{ inputs.names }}" | tr -d ' ')
        IFS=',' read -ra items <<< "${clean_params}"
        
        for item in "${items[@]}"; do
          value=$(./command "$item")
          echo "${item}=${value}" >> "$GITHUB_OUTPUT"
        done

调用工作流时即可直接访问：

- uses: your/action@v1
  id: get-values
  with:
    names: "foo,bar"
- run: |
    echo "Foo value: ${{ steps.get-values.outputs.foo }}"
    echo "Bar value: ${{ steps.get-values.outputs.bar }}"

替代方案2：打包为JSON字符串作为单一输出（适用于完全动态的名称场景） #

将所有动态键值对合并为JSON字符串，通过一个固定输出键返回，调用时用fromJSON解析：

修改Action的脚本部分： #

set -euxo pipefail
clean_params=$(echo "${{ inputs.names }}" | tr -d ' ')
IFS=',' read -ra items <<< "${clean_params}"

# 初始化空JSON对象，依赖runner已安装jq
output_json="{}"
for item in "${items[@]}"; do
  value=$(./command "$item")
  # 将键值对加入JSON
  output_json=$(echo "$output_json" | jq --arg k "$item" --arg v "$value" '. + {($k): $v}')
done

# 输出到固定键
echo "all-values=$output_json" >> "$GITHUB_OUTPUT"

在action.yml中声明固定输出： #

inputs:
  names:
    description: Names to be retrieved

outputs:
  all-values:
    description: All retrieved values in JSON format
    value: ${{ steps.retrieve-values.outputs.all-values }}

runs:
  using: 'composite'
  steps:
    - id: retrieve-values
      shell: bash
      run: |
        # 上面修改后的脚本内容

调用工作流时解析使用： #

- uses: your/action@v1
  id: get-values
  with:
    names: "foo,bar"
- run: |
    echo "Foo value: ${{ fromJSON(steps.get-values.outputs.all-values).foo }}"
    echo "Bar value: ${{ fromJSON(steps.get-values.outputs.all-values).bar }}"

注：如果runner未预装jq，可在Action步骤中先安装jq（比如Ubuntu runner用sudo apt-get install -y jq）。

替代方案3：写入共享文件，在调用工作流中读取（无预声明依赖） #

将动态键值对写入GITHUB_WORKSPACE下的文件，调用工作流直接读取并加载：

修改Action的脚本部分： #

set -euxo pipefail
clean_params=$(echo "${{ inputs.names }}" | tr -d ' ')
IFS=',' read -ra items <<< "${clean_params}"

# 写入共享目录下的文件
output_file="$GITHUB_WORKSPACE/retrieved-values.txt"
> "$output_file" # 清空文件

for item in "${items[@]}"; do
  value=$(./command "$item")
  # 注意：若值包含换行、等号等特殊字符，需做转义处理
  echo "${item}=${value//$'\n'/\\n}" >> "$output_file"
done

调用工作流时读取： #

- uses: your/action@v1
  id: get-values
  with:
    names: "foo,bar"
- run: |
    # 加载文件内容到环境变量
    source $GITHUB_WORKSPACE/retrieved-values.txt
    echo "Foo value: $foo"
    echo "Bar value: $bar"

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