如何将Azure DevOps管道变量设置为值数组以支持迭代遍历

${{ each <var> in <list> }} 是Azure DevOps流水线的编译期模板语法，求值发生在所有流水线任务实际执行之前。你通过PowerShell日志命令导出的是运行时变量，生成时间晚于编译期语法求值阶段，无论你怎么修改变量格式，都不可能被编译期的each语法直接识别遍历，这是流水线执行生命周期的硬规则，和变量类型无关。

方案1：前置列表获取逻辑，适配编译期each语法 #

如果你一定要用${{ each }}语法做遍历，必须把获取ADO构建列表的逻辑挪到流水线编译之前：

• 提前通过脚本/本地PowerShell拉取到需要的构建列表，在触发流水线时，将列表作为数组类型的流水线参数传入，即可直接用each遍历：

parameters:
- name: targetBuildList
  type: object
  default: []

jobs:
- ${{ each buildId in parameters.targetBuildList }}:
  - job: TestForBuild_${{ buildId }}
    steps:
    - script: echo 运行构建${{ buildId }}对应的测试用例

方案2：保留现有PowerShell逻辑，用运行时遍历替代编译期each #

如果不想调整现有逻辑，要在流水线运行时动态拿到列表再遍历，完全可以放弃编译期each语法，有两种成熟的落地方式：

• 方式A：同步骤/后续步骤内直接遍历
  导出变量时用固定分隔符（选不会出现在构建标识里的符号，比如英文逗号）把列表拼接成字符串，后续使用时拆分字符串做循环即可：

  # 拉取构建列表的PowerShell步骤中
  # 假设$buildList是你查询到的构建数组，此处取构建ID拼接为逗号分隔的字符串
  $buildIdStr = $buildList.Id -join ','
  # 导出为ADO变量
  Write-Host "##vso[task.setvariable variable=TargetBuildIds]$buildIdStr"
  

  后续PowerShell步骤中直接拆分遍历：

  $idList = $env:TargetBuildIds -split ','
  foreach ($buildId in $idList) {
      # 此处写入针对单个构建执行测试的逻辑
      Write-Host "开始执行构建$buildId的测试"
  }
  

• 方式B：动态生成作业矩阵，实现和each一致的并行隔离作业效果
  如果你需要给每个构建分配独立的隔离作业运行测试，不需要编译期each也能实现，只要把列表转换为流水线矩阵支持的JSON格式作为输出变量，后续作业直接引用这个动态矩阵即可：

  stages:
  - stage: FetchBuilds
    jobs:
    - job: GetBuildList
      steps:
      - powershell: |
          # 原有拉取构建列表的逻辑，示例为模拟的构建ID数组
          $buildIdList = @(2401,2402,2403)
          $jobMatrix = @{}
          foreach ($id in $buildIdList) {
              $jobMatrix["Build_$id"] = @{ TargetBuildId = $id }
          }
          $matrixJson = $jobMatrix | ConvertTo-Json -Compress
          Write-Host "##vso[task.setvariable variable=BuildJobMatrix;isOutput=true]$matrixJson"
        name: BuildListStep
  - stage: RunAllTests
    dependsOn: FetchBuilds
    variables:
      runtimeMatrix: $[ stageDependencies.FetchBuilds.GetBuildList.outputs['BuildListStep.BuildJobMatrix'] ]
    jobs:
    - job: TestSingleBuild
      strategy:
        matrix: $[ variables.runtimeMatrix ]
      steps:
      - script: echo 执行构建$(TargetBuildId)对应的测试任务
  

  这种方式生成的并行作业和${{ each }}遍历生成的作业效果完全一致，支持每个构建的测试独立运行、独立报错，完全适配你现有动态拉取构建列表的逻辑。

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