队列新构建时VSTS Build变量更新失败问题排查

我来帮你排查下可能遗漏的步骤，这类问题我在处理Azure DevOps（原VSTS）流水线时经常遇到，核心问题通常出在变量更新的方式或者作用域上：

1. 检查PowerShell脚本的变量更新命令是否正确 #

你大概率是直接在脚本里用了普通的变量赋值（比如$YourVar = 11），但这种方式只会在当前PowerShell会话内生效，无法传递给后续的流水线任务。要真正更新流水线级别的变量，必须使用Azure DevOps的专用日志命令：

# 替换成你的变量名，这里假设变量叫BuildVersion
Write-Host "##vso[task.setvariable variable=BuildVersion;]11"

这个命令会告诉流水线引擎更新指定变量的值，后续任务就能读取到新值了。

2. 确认变量的作用域与可修改性 #

• 确保你声明的变量是流水线级别或阶段级别的（不要设置为任务级别，任务级变量只能在当前任务内访问）。
• 如果是队列时手动输入的变量，检查变量面板里的「允许在队列时设置」是否勾选——不过即使勾选，用上面的task.setvariable命令依然能覆盖这个值，只是要确保变量的作用域允许被脚本修改。

3. 验证后续任务的变量引用方式 #

在Update Assembly Info任务中，必须用$(变量名)的格式引用变量，比如$(BuildVersion)，而不是直接写变量名或者其他格式。

建议在Update Assembly Info任务之前加一个临时的PowerShell任务，输出变量值来验证：

Write-Host "当前BuildVersion变量值：$(BuildVersion)"

如果这里输出的是11，说明变量更新成功，问题出在Assembly Info任务的配置上；如果还是1，那就是脚本更新的步骤有问题。

4. 检查任务的作业上下文 #

如果你的PowerShell更新任务和Update Assembly Info任务不在同一个代理作业里，变量更新是不会跨作业生效的。这种情况下需要把变量设置为输出变量：

• 在更新变量的脚本里加上isOutput=true：

  Write-Host "##vso[task.setvariable variable=BuildVersion;isOutput=true;]11"
  

• 在后续作业的变量引用中，用$(前一个作业的名称.BuildVersion)来获取值（比如前一个作业叫Job1，就写$(Job1.BuildVersion)）。

快速验证流程 #

给你一个简单的测试流程，用来定位问题：

1. 在流水线变量面板声明BuildVersion，初始值为1。
2. 添加第一个PowerShell任务，脚本：

   Write-Host "初始值：$(BuildVersion)"
   Write-Host "##vso[task.setvariable variable=BuildVersion;]11"
   Write-Host "脚本内临时值：$BuildVersion" # 这里会显示1，属于正常现象，因为只是当前会话的变量
   

3. 添加第二个PowerShell任务，脚本：

   Write-Host "后续任务读取到的值：$(BuildVersion)" # 这里应该显示11
   

4. 运行流水线，查看第二个任务的输出。如果是11，说明变量更新成功，再去检查Assembly Info任务的配置；如果还是1，回到第一步检查脚本命令是否正确。

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