Azure Pipeline复用模板：动态获取DownloadPipelineArtifact输出变量报错

核心问题分析 #

你遇到的问题源于动态生成的任务名称需要结合编译时表达式（${{ ... }}）和运行时变量引用（$(...)）才能正确获取输出值，之前的语法错误是因为变量键名不正确、表达式嵌套逻辑有误导致的。

解决方案1：将任务输出存入命名规范的变量（推荐） #

在模板中新增步骤，把下载任务的BuildNumber输出存入一个以构件名称命名的独立变量，后续直接引用该变量即可，逻辑更清晰且不易出错：

模板文件（示例：download-artifact.yml） #

parameters:
  - name: ArtifactName
    type: string

steps:
  - task: DownloadPipelineArtifact@2
    name: Download${{parameters.ArtifactName}}
    inputs:
      artifact: ${{parameters.ArtifactName}}
      # 补充你的其他配置（如source、project等）
    displayName: "下载构件: ${{parameters.ArtifactName}}"

  - script: |
      echo "##vso[task.setvariable variable=${{parameters.ArtifactName}}_BuildNumber;]$(Download${{parameters.ArtifactName}}.BuildNumber)"
    displayName: "存储${{parameters.ArtifactName}}的构建编号"

主管道复用模板并获取变量 #

jobs:
  - job: DownloadArtifacts
    steps:
      - template: download-artifact.yml
        parameters:
          ArtifactName: commonScripts

      - template: download-artifact.yml
        parameters:
          ArtifactName: appPackage

      # 打印两个构件的构建信息
      - task: PowerShell@2
        inputs:
          targetType: 'inline'
          script: |
            Write-Host "commonScripts构建编号: $env:commonScripts_BuildNumber"
            Write-Host "appPackage构建编号: $env:appPackage_BuildNumber"

解决方案2：直接正确引用动态任务的输出变量 #

如果不想额外存储变量，可以直接在PowerShell中通过编译时替换生成正确的任务输出引用，修正之前的语法错误：

模板中调整PowerShell步骤 #

parameters:
  - name: ArtifactName
    type: string

steps:
  - task: DownloadPipelineArtifact@2
    name: Download${{parameters.ArtifactName}}
    inputs:
      artifact: ${{parameters.ArtifactName}}
      # 补充你的其他配置
    displayName: "下载构件: ${{parameters.ArtifactName}}"

  - task: PowerShell@2
    inputs:
      targetType: 'inline'
      script: |
        # 编译时会自动将${{parameters.ArtifactName}}替换为实际名称，生成类似$(DownloadcommonScripts.BuildNumber)的引用
        $BuildNumber = "$(Download${{parameters.ArtifactName}}.BuildNumber)"
        Write-Host "${{parameters.ArtifactName}}的构建编号: $BuildNumber"

错误原因说明 #

你之前尝试的$[ variables['${{parameters.ArtifactName}}.BuildNumber']]存在两个问题：

1. 变量键名错误：任务输出变量的键格式为任务名称.输出变量名，即Download${{parameters.ArtifactName}}.BuildNumber，而非${{parameters.ArtifactName}}.BuildNumber
2. 语法嵌套错误：在PowerShell中使用运行时表达式$[ ... ]时，无需额外用单引号包裹，正确写法应为：

$BuildNumber = $[ variables['Download${{parameters.ArtifactName}}.BuildNumber']]

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