跨仓库引用Azure模板时，DisplayName参数替换失效问题

问题根源 #

跨仓库引用模板时，Azure DevOps对运行时变量（$(...)语法）和编译时参数（${{ ... }}语法）的解析时机存在差异：

• 同一仓库内，任务输出的运行时变量可能在流水线编译阶段被提前解析，因此能正常显示在DisplayName中；
• 跨仓库引用时，模板会被独立编译，DisplayName作为任务元数据在初始化阶段就已确定，此时运行时变量（比如任务输出$(get_work_item_from_pr.work_item_id)）还未生成实际值，因此只会显示占位符。

解决方案 #

1. 改用编译时参数语法引用模板参数 #

如果work_item_id是通过模板参数传入的已知值，直接在DisplayName中使用${{ parameters.work_item_id }}替换运行时变量语法：

模板文件（/templates/my-template.yaml）

parameters:
  - name: work_item_id
    type: string
    default: ''

steps:
  - task: PowerShell@2
    displayName: 'Checking work item #${{ parameters.work_item_id }}'
    inputs:
      targetType: 'inline'
      script: |
        # 你的PowerShell脚本内容

调用模板的流水线

steps:
  - template: /templates/my-template.yaml@mytemplates
    parameters:
      work_item_id: '12345'

2. 若需使用任务输出值（可选） #

如果必须用任务输出的work_item_id，需要先将输出值存入阶段变量，再在后续任务的DisplayName中引用（注意：这种方式下DisplayName仍会在编译阶段显示占位符，任务执行后才会更新为实际值，但跨仓库场景下需确保变量作用域正确）：

模板文件修改

steps:
  - task: PowerShell@2
    name: get_work_item_from_pr
    inputs:
      targetType: 'inline'
      script: |
        # 模拟获取work item ID的逻辑
        $workItemId = "12345"
        Write-Host "##vso[task.setvariable variable=workItemId;isOutput=true]$workItemId"
  - task: PowerShell@2
    displayName: 'Checking work item #$(get_work_item_from_pr.workItemId)'
    inputs:
      targetType: 'inline'
      script: |
        # 脚本内容

这种方式下，流水线运行时任务执行后，DisplayName会更新为实际值，但初始化阶段仍会显示占位符，若需要初始化阶段就显示正确值，优先用方案1。

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