Azure Pipeline中变量赋值后未更新问题排查

问题现象 #

基于Git仓库提交数量更新Azure Pipeline变量时，可正确获取分支提交总计数，但无法在流程中读取到更新后的变量值，最终拼接的版本号缺失修订号段。

现有配置 #

初始变量定义 #

variables:
  # Versioning
  # Version Format - 'VersionMajor.VersionMinor.VersionRelease.Revision'
  # Currently the Major, Minor and Release are all constants
  - name: VersionMajorMinorRelease
    value: '1.0.1'
    
  # Revision will be calculated during pipeline run based on total commit counts for branch
  - name: VersionRevision
    value: ''

变量设置任务配置 #

- task: PowerShell@2
  displayName: Set the build version
  condition: eq('${{ parameters.Action }}', 'BuildAndDeploy')
  inputs:
    targetType: inline
    script: |
      $commitCounts= $(git rev-list --count HEAD)
      $revision= $commitCounts.ToString()
      Write-Host "Revision = '$revision'"
      Write-Host "##vso[task.setvariable variable=VersionRevision]$revision"
      Write-Host "Version of App being built = '$(VersionMajorMinorRelease).$(VersionRevision)'"

运行输出 #

Revision = '1660'
Version of App being built = '1.0.1.'

输出显示修订号已正确获取为1660，但拼接版本号时VersionRevision为空值。

根因分析 #

问题出在Azure Pipeline的变量解析机制：

• 使用$(变量名)格式的宏语法变量，会在任务启动前完成全量替换，任务运行过程中通过##vso[task.setvariable]命令修改的变量，不会在当前任务内被宏语法重新读取。
• 配置中的setvariable命令本身没有错误，变量实际已经被成功赋值，只是在同一个PowerShell任务内无法通过$(VersionRevision)读取到刚更新的值，才会出现拼接结果为空的现象。
• 额外风险：直接获取git命令返回值时可能携带末尾换行、空白字符，容易导致变量值存在不可见异常。

修复方案 #

1. 同一个PowerShell脚本内需要使用修订号时，直接调用本地变量$revision拼接，不要使用$(VersionRevision)宏语法。
2. 为git返回结果增加Trim处理，去除多余空白字符。
3. 变量设置命令保持不变，后续独立的任务步骤中可以正常通过$(VersionRevision)读取到更新后的值；如果需要跨作业、跨阶段使用该变量，在setvariable命令中增加isOutput=true参数，按输出变量规则引用即可。

修正后的任务配置 #

- task: PowerShell@2
  displayName: Set the build version
  condition: eq('${{ parameters.Action }}', 'BuildAndDeploy')
  inputs:
    targetType: inline
    script: |
      $commitCounts = git rev-list --count HEAD
      $revision = $commitCounts.ToString().Trim()
      Write-Host "Revision = '$revision'"
      Write-Host "##vso[task.setvariable variable=VersionRevision]$revision"
      # 同脚本内直接使用本地变量拼接版本号
      $fullVersion = "$(VersionMajorMinorRelease).$revision"
      Write-Host "Version of App being built = '$fullVersion'"

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