如何在NUKE中设置变量供GitHub Actions矩阵使用（替代弃用的::set-output）

核心问题分析 #

你当前的写法存在两个关键问题：

• PowerShell环境下，单引号包裹的'$env:GITHUB_OUTPUT'不会解析环境变量，而是直接将该字符串作为文件名，导致输出没有写入GitHub指定的GITHUB_OUTPUT文件。
• 若JSON数组包含特殊字符，未正确处理转义会导致后续步骤无法解析变量。

修正后的实现方案 #

1. NUKE目标中正确输出到GITHUB_OUTPUT #

在NUKE的C#代码里，执行正确的PowerShell命令，避免用单引号包裹环境变量：

// 假设已获取到配置列表，如List<string> configurations
var jsonConfig = JsonConvert.SerializeObject(configurations);
// 直接引用环境变量，无需额外单引号包裹
ExecuteShell($"echo configurations={jsonConfig} >> $env:GITHUB_OUTPUT");

如果需要处理特殊字符，可改用更安全的写法：

var jsonConfig = JsonConvert.SerializeObject(configurations);
// 使用PowerShell的双引号包裹键值对，避免特殊字符干扰
ExecuteShell($"echo \"configurations={jsonConfig}\" >> $env:GITHUB_OUTPUT");

2. GitHub Actions中正确传递输出 #

确保第一个任务设置id，后续任务通过该id引用输出：

jobs:
  extract-configs:
    runs-on: ubuntu-latest
    outputs:
      configurations: ${{ steps.nuke-extract.outputs.configurations }}
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Extract configurations via NUKE
        id: nuke-extract
        run: dotnet run --project ./Build/Build.csproj --target ExtractConfigurations

  build:
    needs: extract-configs
    runs-on: ubuntu-latest
    strategy:
      matrix:
        config: ${{ fromJson(needs.extract-configs.outputs.configurations) }}
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Build with NUKE
        run: dotnet run --project ./Build/Build.csproj --target Build --configuration ${{ matrix.config }}

3. 验证步骤（可选） #

• 在NUKE目标中添加日志，确认JSON格式正确：

  Logger.Info("Generated configurations JSON: {0}", jsonConfig);
  

• 在GitHub Actions的第一个任务后，添加步骤验证输出是否写入成功：

  - name: Check output content
    run: cat $GITHUB_OUTPUT
  

关键注意事项 #

• 若使用Windows runner，PowerShell语法一致，但需确保NUKE的JsonConvert已正确处理JSON中的引号转义。
• 输出的JSON数组必须是标准格式，例如["Debug","Release"]，不能包含多余空格或换行。

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