GitHub Actions：如何用动态输入变量替换输出中的硬编码值

问题说明 #

原本硬编码指定输出属性时能正常运行，比如：

app_namexx: ${{ steps.run-script.outputs.app_name }}

但想要将硬编码的app_name替换为工作流输入变量key_name时，多种写法均报错：

The workflow is not valid. Error from called workflow. Unrecognized named-value: 'key_name'. Located at position 27 with expression: steps.run-script.outputs[key_name]

尝试过的写法包括：

app_namexx: ${{ steps.run-script.outputs[key_name] }}
app_namexx: ${{ steps.run-script.outputs[$key_name] }}
app_namexx: ${{ steps.run-script.outputs.$key_name }}
app_namexx: ${{ steps.run-script.outputs.${key_name} }}
app_namexx: ${{ steps.run-script.outputs.${ inputs.key_name } }} 

需求是通过PowerShell解析键值对格式的XML，每次传入不同的key_name时，可重用工作流返回对应的值；若key_name为空，则返回所有键值对，核心是解决工作流输出中动态引用输入变量的问题。

解决方案 #

1. 正确的动态属性引用语法 #

GitHub Actions的表达式中，动态访问outputs的属性时，必须通过**inputs.key_name**完整引用输入变量，正确写法为：

app_namexx: ${{ steps.run-script.outputs[inputs.key_name] }}

之前报错的原因是没有添加inputs.前缀，导致GitHub Actions无法识别key_name是工作流输入变量，而是将其当作了未定义的内部变量。

2. 处理key_name为空的场景 #

在PowerShell脚本中加入判断逻辑，根据传入的key_name决定输出内容：

# 假设已解析XML得到键值对哈希表$keyValuePairs
if (-not $env:INPUT_KEY_NAME) {
    # 若key_name为空，输出所有键值对（转为JSON方便传递）
    echo "result=$($keyValuePairs | ConvertTo-Json -Compress)" >> $env:GITHUB_OUTPUT
} else {
    # 若指定了key_name，输出对应的值
    echo "$($env:INPUT_KEY_NAME)=$($keyValuePairs[$env:INPUT_KEY_NAME])" >> $env:GITHUB_OUTPUT
}

注意：这里直接将目标键值输出到GITHUB_OUTPUT，后续工作流可以通过steps.run-script.outputs[inputs.key_name]获取对应值，空值场景下统一用result输出所有内容。

完整可重用工作流示例 #

# .github/workflows/reusable-xml-parser.yml
name: XML Key-Value Parser
on:
  workflow_call:
    inputs:
      key_name:
        type: string
        required: false
        default: ""
    outputs:
      target_value:
        description: "对应key_name的值，若为空则返回所有键值对"
        value: ${{ inputs.key_name != '' && steps.parse-xml.outputs[inputs.key_name] || steps.parse-xml.outputs.result }}

jobs:
  parse-xml:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Parse XML and output key-value
        id: parse-xml
        shell: pwsh
        run: |
          # 示例：解析XML为键值对哈希表（替换为你的实际XML解析逻辑）
          $xmlContent = Get-Content -Path "./config.xml" -Raw
          $xml = [xml]$xmlContent
          $keyValuePairs = @{}
          foreach ($node in $xml.Configuration.Settings.Setting) {
              $keyValuePairs[$node.Key] = $node.Value
          }

          # 根据key_name输出结果
          if (-not "${{ inputs.key_name }}") {
              echo "result=$($keyValuePairs | ConvertTo-Json -Compress)" >> $env:GITHUB_OUTPUT
          } else {
              echo "${{ inputs.key_name }}=$($keyValuePairs["${{ inputs.key_name }}"])" >> $env:GITHUB_OUTPUT
          }

调用该可重用工作流的示例 #

# .github/workflows/caller-workflow.yml
name: Call XML Parser
on: [push]

jobs:
  get-app-name:
    uses: ./.github/workflows/reusable-xml-parser.yml
    with:
      key_name: "app_name"
    outputs:
      app_value: ${{ jobs.get-app-name.outputs.target_value }}

  get-all-settings:
    uses: ./.github/workflows/reusable-xml-parser.yml
    outputs:
      all_settings: ${{ jobs.get-all-settings.outputs.target_value }}

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