如何在Composite Action中动态设置输出变量？

核心问题原因 #

GitHub复合动作（Composite Action）的输出变量必须在action.yml的outputs字段中预先声明，哪怕你通过echo "key=value" >> $GITHUB_OUTPUT动态写入未声明的键，这些输出也不会被暴露给调用该动作的工作流。这是复合动作的设计限制，和普通作业（Job）的动态输出逻辑不同。

可行方案：用单一JSON输出打包动态键值对 #

既然无法动态添加未声明的输出，我们可以把所有动态生成的键值对打包成一个JSON字符串，通过一个预先声明的固定输出传递给后续步骤，再在步骤中解析JSON提取所需值。

步骤1：修改复合动作的action.yml

先在action.yml中声明一个固定输出，用于承载所有动态内容：

name: "你的复合动作名称"
outputs:
  dynamic-outputs:
    description: "所有动态生成的键值对，以JSON格式存储"
runs:
  using: composite
  steps:
    - run: |
        # 初始化空JSON对象
        DYNAMIC_OUTPUTS="{}"
        
        # 你的KEYS列表提取逻辑
        [...]
        
        for (( i=0; i<${#KEYS[@]}; i++ ))
        do
          RESULT= # 你的取值逻辑
          NAME=$(echo "${KEYS[$i]}" | sed 's/[^A-Za-z0-9_]/-/g')
          
          # 用jq将键值对添加到JSON对象（避免手动拼接JSON的格式错误）
          DYNAMIC_OUTPUTS=$(echo "$DYNAMIC_OUTPUTS" | jq --arg k "$NAME" --arg v "$RESULT" '. + {($k): $v}')
        done
        
        # 将JSON输出到GITHUB_OUTPUT
        echo "dynamic-outputs=$DYNAMIC_OUTPUTS" >> $GITHUB_OUTPUT
      shell: bash

步骤2：在工作流中解析JSON输出

调用复合动作后，用jq工具解析JSON字符串，提取需要的字段：

- uses: actions/checkout@v3

- name: Call action
  id: read-file
  uses: <owner>/<action-repo>@main

- name: Print dynamic outputs
  run: |
    # 获取复合动作输出的JSON
    DYNAMIC_JSON='${{ steps.read-file.outputs.dynamic-outputs }}'
    
    # 提取指定键的值
    echo "my-key的值: $(echo "$DYNAMIC_JSON" | jq -r '.["my-key"]')"
    echo "my-other-key的值: $(echo "$DYNAMIC_JSON" | jq -r '.["my-other-key"]')"

补充说明 #

• GitHub托管的Runner默认已安装jq，如果是自托管Runner，需要提前安装该工具。
• 如果动态值中包含特殊字符（如引号、换行），JSON格式能自动处理转义，比手动拼接字符串更可靠。

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