Azure Pipeline中使用变量执行##vso[build.addbuildtag]添加标签失败

以下是几种可能导致该问题的原因及对应排查思路：

• 变量包含首尾空白字符
  即便echo能输出变量内容，也可能存在空格、换行或制表符这类不可见空白。Azure Build Tag不允许包含空白字符，直接使用$(ChangeNumber)会把空白带入，导致标签被判定为空。可以尝试用Trim处理变量：

  echo "##vso[build.addbuildtag]$($(ChangeNumber).Trim())"
  

  或者在变量定义阶段就清理掉多余空白。

• 变量作用域不匹配
  执行标签添加命令的任务，可能和$(ChangeNumber)变量的定义不在同一作用域。比如变量是在某Stage/Job内定义的，而添加标签的任务属于另一个无法访问该变量的作用域。即便之前的echo能输出变量，也可能是在变量生效的任务内执行的，换任务后就取不到有效值了。

• 变量解析时机差异
  两个Pipeline的变量解析规则可能不同，当前出问题的Pipeline中，$(ChangeNumber)可能是模板参数或运行时动态变量，解析时机晚于命令执行，导致实际传递给addbuildtag的是空字符串。可以尝试改用PowerShell环境变量引用方式：

  echo "##vso[build.addbuildtag]$env:ChangeNumber"
  

• 任务/代理版本不一致
  两个Pipeline使用的代理池或Azure Pipeline任务版本存在差异，旧版本任务对变量解析的兼容性较差，导致变量无法正确替换。检查两个Pipeline的代理配置，或更新相关任务到最新版本。

• 变量值含非法字符
  如果$(ChangeNumber)包含逗号、分号、尖括号等Azure Build Tag不允许的特殊字符，也会触发标签无效错误。可以将变量值完整输出到日志，仔细检查是否存在特殊字符，必要时做转义或过滤处理。

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