如何在Azure DevOps YAML管道each循环中使用数组变量

首先明确核心限制：你示例中使用的${{ each records in variables.records.Records }}属于模板编译期语法，仅在YAML文件编译解析阶段生效，只能读取编译前就确定值的静态参数、变量，完全无法读取运行时（比如PowerShell任务执行过程中）才生成的动态值，因此原写法无法直接生效。

问题1：数组变量的存储与调用规则 #

• 普通Azure DevOps管道变量默认是字符串类型，就算你在PowerShell中定义了数组类型的$records.Records，如果要跨任务传递，直接通过##vso[task.setvariable]赋值会被自动转成字符串，无法直接被编译期循环语法识别。
• 如果你不需要拆分独立任务，所有逻辑都可以在同一个PowerShell任务内完成，不需要额外存储数组变量，直接在脚本内遍历即可。
• 如果你需要调用独立的非PowerShell任务，无法在单作业的运行时阶段直接用模板语法遍历运行时生成的数组，必须走额外的实现方案。

问题2：可行替代方案 #

方案1：单作业内PowerShell统一执行（最简单，同作业顺序执行场景） #

如果你的两个非PowerShell任务有可通过命令行/REST API调用的入口，不需要依赖现成的管道任务UI配置，直接在获取记录的同一个PowerShell脚本内遍历数组，顺序执行对应逻辑即可，不需要拆分作业或阶段：

- task: PowerShell@2
  displayName: 批量处理所有记录
  inputs:
    targetType: 'inline'
    script: |
      # 原有获取记录逻辑
      $records = <获取$records的代码>
      # 遍历每条记录
      foreach($singleRecord in $records.Records){
        Write-Host "开始处理记录：$singleRecord，执行第一步操作"
        # 替换为原name1任务对应的命令/API调用逻辑
        <name1任务的执行代码>
        
        Write-Host "记录$singleRecord第一步完成，执行第二步操作"
        # 替换为原name2任务对应的命令/API调用逻辑
        <name2任务的执行代码>
      }

方案2：拆分双作业+动态矩阵（支持独立管道任务，可顺序/并行执行） #

如果必须使用现成的独立管道任务（不能把逻辑合并到PowerShell），可以拆成两个作业，利用作业输出变量+动态矩阵实现遍历：

1. 第一个作业仅负责拉取记录列表，把数组转换成矩阵要求的JSON格式，设置为作业级输出变量
2. 第二个作业依赖第一个作业的输出，动态生成矩阵，每个矩阵维度对应一条记录，维度内部按顺序放你需要执行的两个任务

示例YAML：

stages:
- stage: stage_1
  jobs:
  - job: 拉取记录列表
    pool:
      vmImage: 'ubuntu-latest'
    steps:
    - task: PowerShell@2
      name: 生成矩阵变量
      inputs:
        targetType: 'inline'
        script: |
          # 原有获取记录逻辑
          $records = <获取$records的代码>
          # 拼接矩阵要求的格式：key为记录唯一标识，value为该记录对应的参数键值对
          $matrixConfig = @{}
          foreach($r in $records.Records){
            $matrixConfig[$r] = @{
              currentRecord = $r
            }
          }
          # 序列化为JSON输出为作业变量
          $matrixJson = $matrixConfig | ConvertTo-Json -Compress
          Write-Host "##vso[task.setvariable variable=recordMatrix;isOutput=true]$matrixJson"

  - job: 逐条处理记录
    dependsOn: 拉取记录列表
    pool:
      vmImage: 'ubuntu-latest'
    strategy:
      # 读取上游作业输出的JSON转成矩阵，需要顺序执行就加parallel:1配置
      parallel: 1
      matrix: $[ convertFromJson(dependencies.拉取记录列表.outputs['生成矩阵变量.recordMatrix']) ]
    steps:
    - task: not_powershell
      displayName: name1_$(currentRecord)
      inputs:
        AsyncOperation: true
        MaxAsyncWaitTime: '60'
        # 任务入参通过$(currentRecord)读取当前遍历到的记录值
        targetRecord: $(currentRecord)

    - task: not_powershell
      displayName: name2_$(currentRecord)
      inputs:
        AsyncOperation: true
        MaxAsyncWaitTime: '60'
        targetRecord: $(currentRecord)

说明：如果不需要顺序执行，删掉parallel: 1配置即可让多条记录的处理逻辑并行跑，提升执行效率。

方案3：动态生成模板YAML（复杂场景适用） #

如果流程复杂度更高，可以在拉取记录的步骤后通过脚本动态生成下游阶段/作业的YAML文件，再通过模板引用的方式加载执行，该方案灵活度最高，但配置复杂度也高，普通场景优先选前两个方案即可。

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