Azure DevOps Pipeline条件判断异常：变量值未正确生效

问题描述 #

我有一个Azure DevOps Pipeline，用于检查提交是否带有版本格式的标签（如v1.0.0或v01.00.00）。当前遇到的问题是：PowerShell任务中通过正则判断得到的isVersionTag变量，在任务内逻辑判定为True，但后续任务的condition中却被判定为初始值False，导致后续任务无法执行。

原Pipeline代码 #

# Starter pipeline
# Start with a minimal pipeline that you can customize to build and deploy your code.
# Add steps that build, run tests, deploy, and more:
# https://aka.ms/yaml

trigger:
  branches:
    include:
      - master
  tags:
    include:
      - "*"

pool:
  vmImage: windows-latest

variables:
  hasTags: $[contains(variables['Build.SourceBranch'], 'refs/tags/')]
  isVersionTag: 'False'
  versionTag: ''

steps:

- task: PowerShell@2
  condition: eq(variables.hasTags, 'True')
  inputs:
    targetType: 'inline'
    script: |
      # get the tag the from the SourcheBranch
      $dummy = $Env:Build_SourceBranch
      $regex = "(refs)\/(tags)\/(?<version_tag>.+)$"
      $result = [regex]::Matches($dummy, $regex)
      $Env:versionTag = $result[0].Groups["version_tag"].Value

      # check if the tag is actually a version (e.g. 'v1.0.1')
      $regex = "v[0-9]{1,}\.[0-9]{1,}\.[0-9]{1,}$"
      $Env:isVersionTag = [regex]::IsMatch($Env:versionTag, $regex)

      if($Env:isVersionTag -eq 'True')
      {
        Write-Host 'It is a version tag'
      }

      Write-Host "Variable Build.SourceBranch = $Env:Build_SourceBranch"
      Write-Host "Variable isVersionTag = $Env:isVerionTag"
      Write-Host "Variable hasTags = $Env:hasTags"
      Write-Host "Variable versionTag = $Env:versionTag"

# This will not run because the condition is evaluated as the following:
# Evaluating: and(eq(variables['hasTags'], 'True'), eq(variables['isVersionTag'], 'True'))
# Expanded: and(eq('True', 'True'), eq('False', 'True'))
# Result: False
- task: PowerShell@2
  condition: and(eq(variables.hasTags, 'True'), eq(variables.isVersionTag, 'True'))
  inputs:
    targetType: 'inline'
    script: |
      # Write your PowerShell commands here.
      
      Write-Host "The tag is a version tag"

执行输出 #

It is a version tag
Variable Build.SourceBranch = refs/tags/v02.01.07
Variable isVersionTag = 
Variable hasTags = True
Variable versionTag = v02.01.07

问题分析 #

1. 变量作用域不匹配：Pipeline中定义的isVersionTag是阶段级变量，直接修改PowerShell的环境变量$Env:isVersionTag不会同步到Pipeline的全局变量上下文，后续任务读取的始终是初始值'False'。
2. 拼写错误：执行输出中的Write-Host "Variable isVersionTag = $Env:isVerionTag"存在拼写错误（isVerionTag少写了一个s），导致输出中isVersionTag为空，但这不是核心问题。
3. 布尔值类型转换问题：[regex]::IsMatch()返回的是PowerShell布尔类型（$true/$false），直接赋值给环境变量会被自动转换，但无法被Pipeline变量系统识别。

修复方案 #

要让PowerShell任务中修改的变量被后续任务识别，必须使用Azure DevOps的任务命令同步变量到Pipeline上下文，具体修改如下：

1. 修正PowerShell任务的变量设置逻辑 #

替换直接修改$Env:变量的代码，改用Write-Host "##vso[task.setvariable variable=变量名;]值"格式设置变量，同时修正拼写错误：

- task: PowerShell@2
  condition: eq(variables.hasTags, 'True')
  inputs:
    targetType: 'inline'
    script: |
      # 获取标签
      $dummy = $Env:Build_SourceBranch
      $regex = "(refs)\/(tags)\/(?<version_tag>.+)$"
      $result = [regex]::Matches($dummy, $regex)
      $versionTag = $result[0].Groups["version_tag"].Value
      # 将versionTag同步到Pipeline变量
      Write-Host "##vso[task.setvariable variable=versionTag;]$versionTag"

      # 校验版本标签格式
      $regex = "v[0-9]{1,}\.[0-9]{1,}\.[0-9]{1,}$"
      $isVersionTag = [regex]::IsMatch($versionTag, $regex)
      # 转换为字符串后同步到Pipeline变量
      Write-Host "##vso[task.setvariable variable=isVersionTag;]$($isVersionTag.ToString())"

      if($isVersionTag)
      {
        Write-Host 'It is a version tag'
      }

      Write-Host "Variable Build.SourceBranch = $Env:Build_SourceBranch"
      Write-Host "Variable isVersionTag = $isVersionTag"
      Write-Host "Variable hasTags = $Env:hasTags"
      Write-Host "Variable versionTag = $versionTag"

2. 保留后续任务的Condition逻辑 #

后续任务的condition无需修改，现在isVersionTag已经被正确同步为Pipeline变量，条件判断会生效：

- task: PowerShell@2
  condition: and(eq(variables.hasTags, 'True'), eq(variables.isVersionTag, 'True'))
  inputs:
    targetType: 'inline'
    script: |
      Write-Host "The tag is a version tag"

额外优化：直接用Pipeline表达式完成校验（可选） #

如果不需要复杂的PowerShell逻辑，可以直接在Pipeline变量中用表达式提取标签并校验，省去PowerShell任务：

variables:
  hasTags: $[contains(variables['Build.SourceBranch'], 'refs/tags/')]
  versionTag: $[replace(variables['Build.SourceBranch'], 'refs/tags/', '')]
  isVersionTag: $[matches(variables['versionTag'], '^v[0-9]+\.[0-9]+\.[0-9]+$')]

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