Azure DevOps Pipeline表达式Split()无法循环字符串，求原因及解决

需求背景 #

• 自动化清理Azure Repos中残留的陈旧及已合并PR分支
• 打造通用型Pipeline，借助模板简化维护、降低管理成本

失败尝试过程 #

通过PowerShell脚本收集ADO项目内所有仓库，将仓库名数组转为逗号分隔字符串存入AllRepos变量；尝试使用Pipeline编译时表达式${{ each repo in split('$(AllRepos)', ',') }}循环处理仓库，但该表达式未正确拆分字符串——仅移除逗号并将整体视为单个对象，无法生成多任务（日志输出无逗号的完整字符串，未触发循环逻辑）。

原失败代码：

stages:
  - stage: CleanProjectRepoBranches
    pool:
      name: 'DevOps Pool'
    jobs:
     - job: GetRepos
       displayName: 'Get All Repos for Project'
       steps:
        - checkout: none
        - task: PowerShell@2
          displayName: 'Gather all Repos in $(projectName)'
          inputs:
            targetType: 'inline'
            script: |
              $env:AZURE_DEVOPS_EXT_PAT = '$(projectPAT)'
              $repos= (az repos list --organization '$(orgUrl)' --project '$(projectName)' | ConvertFrom-Json | Select-Object name).name -join ','

              Write-Host '============================================================================================'
              Write-Host 'Repos: ' $repos
              Write-Host '============================================================================================'

              Write-Host "##vso[task.setvariable variable=AllRepos;]$repos"

        - script: echo "AllRepos is $(AllRepos)"

        - ${{ each repo in split('$(AllRepos)', ',') }}:
            - task: PowerShell@2
              displayName: 'Test'
              inputs:
                targetType: 'inline'
                script: |
                  Write-Host '============================================================================================'
                  Write-Host ${{repo}}
                  Write-Host '============================================================================================'

变通解决方案 #

明确Azure DevOps Pipeline的编译时与运行时特性差异后，调整方案：将AllRepos设为作业输出变量，在后续作业中通过PowerShell脚本拆分字符串，循环生成JSON参数调用目标Pipeline模板。

具体代码：

stages:
  - stage: GetAllProjectRepos
    pool:
      name: 'DevOps Pool'
    jobs:
     - job: GetRepos
       displayName: 'Get All Repos for Project'
       steps:
        - checkout: none
        - task: PowerShell@2
          displayName: 'Put all repo names into runtime variable'
          inputs:
            targetType: 'inline'
            script: |
              $env:AZURE_DEVOPS_EXT_PAT = '$(projectPAT)'
              $repos= (az repos list --organization '$(orgUrl)' --project '$(projectName)' | ConvertFrom-Json | Select-Object name).name -join ','

              Write-Host '============================================================================================'
              Write-Host 'Repos: ' $repos
              Write-Host '============================================================================================'

              Write-Host "##vso[task.setvariable variable=AllRepos;isOutput=true]$repos"
          name: ReposList

     - job: CleanUp
       displayName: 'Clean Undeleted PR Branches from Project repos'
       dependsOn: 'GetRepos'
       variables:
         AllRepos: $[ dependencies.GetRepos.outputs['ReposList.AllRepos'] ]
       steps:
        - checkout: none

        - task: PowerShell@2
          displayName: 'Get Pipeline ID'
          inputs:
            targetType: 'inline'
            script: |
                $env:AZURE_DEVOPS_EXT_PAT = '$(projectPAT)'
                az devops configure --defaults organization='$(orgUrl)'
                az devops configure --defaults project='$(projectName)'
                Write-Host '============================================================================================'
                Write-Host 'GitCleanup Pipeline ID (also called Definition)'
                $pipelineId = az pipelines list --query "[?name == 'Git Clean Branches'].id"
                $pipelineId = $pipelineId[1].Trim()
                Write-Host "##vso[task.setvariable variable=GitCleanPipelineId;]$pipelineId"
                Write-Host 'GitCleanup ID: ' $pipelineId

        - task: PowerShell@2
          displayName: 'Calling GitCleanup Pipeline'
          inputs:
            targetType: 'inline'
            script: |
              $base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f "","$(projectPAT)")))
              $uri = "$(orgUrl)/$(projectName)/_apis/pipelines/$(GitCleanPipelineId)/runs?api-version=6.0-preview.1"
              Write-Host '============================================================================================'
              Write-Host $uri
              Write-Host '============================================================================================'

              $repos = '$(AllRepos)'
              $repos.split(",") | ForEach {
                $jsonHashTable= @{
                    'templateParameters' = @{
                      'repoName' = $_
                      'deletePRBranches' = 'true'
                      'deleteStaleBranches' = 'false'
                    }
                  }

                $JSON = $jsonHashTable | ConvertTo-Json

                Write-Host '============================================================================================'
                Write-Host $JSON
                Write-Host '============================================================================================'
                Write-Host '============================================================================================'
                $reponse = Invoke-RestMethod -Uri $uri -Headers @{Authorization = "Basic $base64AuthInfo"} -Method Post -Body $JSON -ContentType application/json
                Write-Host "API Response"
                Write-Host $response
                Write-Host '============================================================================================'
              }

疑问解答 #

这是Azure DevOps Pipeline的编译时表达式与运行时变量的特性限制，并非表达式使用错误：

• ${{ ... }}属于编译时表达式，在Pipeline启动前就会完成解析；而$(AllRepos)是运行时变量，只有在Pipeline执行过程中才会被赋值
• 编译时解析split('$(AllRepos)', ',')时，$(AllRepos)还未被替换为实际的仓库列表字符串，只是作为纯文本处理——因为该字符串本身不含逗号，split后仅得到单个元素的数组，自然无法生成多任务循环
• 因此必须通过运行时逻辑处理动态生成的列表，比如你采用的PowerShell拆分循环调用，或者结合Azure DevOps REST API实现批量触发

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