Azure DevOps Pipeline：BuildNumber变量可解析但构建名称无法解析

配置的YAML片段如下：

variables:
- group: NumVersion
- name: upperversion
  ${{ if eq(parameters.VersionBuild,'ReleaseProd') }}:
    value: $(1-VersionMajeur).$(2-VersionMineure-ReleaseProd)
  ${{ if eq(parameters.VersionBuild,'Release') }}:
    value: $(1-VersionMajeur).$(2-VersionMineure-Release)
  ${{ if eq(parameters.VersionBuild,'Develop') }}:
    value: $(1-VersionMajeur).$(2-VersionMineure-Dev)

- name: lowerversion
  ${{ if eq(parameters.TypeBuild,'Feature') }}:
    value: 99.$(Build.BuildId)
  ${{ if eq(parameters.TypeBuild,'Validation') }}:
    value: 0.$(Build.BuildId)

name: $(upperversion).$(lowerversion)

steps:
  - script: |
       echo $(Build.BuildNumber)
       echo $(upperversion)
       echo $(lowerversion)
    displayName: Second variable pass

脚本输出显示Build.BuildNumber、upperversion、lowerversion均能正确解析，但构建名称中的变量未被替换，仍显示原始的$(upperversion).$(lowerversion)形式。

核心原因 #

Azure DevOps中，name字段属于模板编译阶段处理的内容，而你定义的upperversion、lowerversion是运行时变量，编译阶段无法获取这些变量的实际值，因此无法解析。

方法一：改用编译时变量定义 #

将自定义变量改为编译时语法（${{ }}），让变量在编译阶段就完成赋值，这样name字段就能直接解析：

variables:
- group: NumVersion
- name: upperversion
  value: ${{ 
    eq(parameters.VersionBuild,'ReleaseProd') && variables['1-VersionMajeur'] + '.' + variables['2-VersionMineure-ReleaseProd'] ||
    eq(parameters.VersionBuild,'Release') && variables['1-VersionMajeur'] + '.' + variables['2-VersionMineure-Release'] ||
    eq(parameters.VersionBuild,'Develop') && variables['1-VersionMajeur'] + '.' + variables['2-VersionMineure-Dev']
  }}
- name: lowerversion
  value: ${{
    eq(parameters.TypeBuild,'Feature') && '99.' + variables['Build.BuildId'] ||
    eq(parameters.TypeBuild,'Validation') && '0.' + variables['Build.BuildId']
  }}

name: ${{ variables.upperversion }}.${{ variables.lowerversion }}

注意：变量组中的1-VersionMajeur等变量需确保在编译阶段可访问（默认组变量编译阶段可用，若设为“Secret”或“Runtime only”则需调整）。

方法二：动态修改构建名称（运行时） #

如果必须保留运行时变量，可通过调用Azure DevOps REST API在步骤中动态修改构建名称：

steps:
  - script: |
       echo $(Build.BuildNumber)
       echo $(upperversion)
       echo $(lowerversion)
    displayName: Second variable pass

  - script: |
      NEW_BUILD_NAME="$(upperversion).$(lowerversion)"
      curl -X PATCH \
        -H "Content-Type: application/json" \
        -H "Authorization: Bearer $(System.AccessToken)" \
        "$(System.TeamFoundationCollectionUri)$(System.TeamProject)/_apis/build/builds/$(Build.BuildId)?api-version=7.1-preview.7" \
        -d "{\"name\":\"$NEW_BUILD_NAME\"}"
    displayName: Update Build Name
    env:
      SYSTEM_ACCESSTOKEN: $(System.AccessToken)

注意：需给构建服务账号分配“Edit build pipeline”权限，否则API调用会失败。

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