TFS构建定义：是否存在捕获构建失败原因的预定义变量？

我来帮你梳理下这个问题——TFS（现在也常被称为Azure DevOps Server）里确实没有直接返回“构建失败原因”的单一预定义变量，但我们可以通过现有变量加一点小技巧来实现你的需求。

可用的相关预定义变量 #

• $(Build.Status)：这个变量会返回构建的最终状态，比如Failed、Succeeded，但它只表示状态，不包含具体失败原因。
• $(Build.FailureMessage)：这个变量会携带构建失败的简短错误描述，比如“NuGet还原任务执行失败”“单元测试未通过”这类信息，是最接近你需求的变量。
• $(Build.LogUri)：它指向构建日志的链接，虽然不能直接当标签，但可以作为工作项的补充信息，方便后续查看详细失败细节。

实现思路（把失败原因转为标签） #

因为工作项标签需要简洁，所以需要对现有变量的内容做处理，这里给你两种实用方法：

1. 提取$(Build.FailureMessage)的关键内容
   你可以在创建工作项的前置步骤（比如添加一个PowerShell脚本任务）里，对$(Build.FailureMessage)做字符串截取，提取核心关键词作为标签。举个简单的PowerShell示例：

# 获取失败信息
$failureDetails = "$(Build.FailureMessage)"
# 提取第一个冒号前的关键内容作为标签（可根据实际格式调整）
$failureTag = $failureDetails.Split(':')[0].Trim()
# 将提取的标签存入变量，供后续创建工作项时使用
Write-Host "##vso[task.setvariable variable=FailureTag]$failureTag"

之后在创建工作项的任务中，把$(FailureTag)赋值给system.tags即可。

2. 基于失败任务名称设置标签
   如果你的构建流程中每个任务的职责很明确，也可以给每个关键任务添加一个“失败触发”的后续任务，当该任务失败时，设置对应的标签变量。比如：

• 给“NuGet还原”任务添加一个条件为Failed的PowerShell任务，设置标签变量为NuGet还原失败
• 给“单元测试”任务添加类似的条件任务，设置标签变量为单元测试失败
  最后创建工作项时，直接使用这个预先设置好的标签变量。

注意事项 #

• TFS工作项标签有字符限制，要确保提取的内容简短，避免包含特殊字符（比如冒号、斜杠等）。
• $(Build.FailureMessage)的内容格式会根据失败类型变化，所以字符串处理逻辑可能需要根据你的具体构建任务调整，避免提取出无效内容。

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