DevOps构建模板：多工作区映射场景下的构建变量咨询

碰到多工作区映射时$(Build.SourceBranch)返回空的问题确实挺常见的——毕竟这个变量是绑定到单一触发分支的，当有多个工作区映射时，系统没法确定该返回哪个分支的路径。针对你想要获取首个工作区映射或当前构建解决方案源路径的需求，这里有几个靠谱的方案：

1. 用$(Build.Repository.LocalPath)获取本地代码根路径 #

这个变量会直接返回构建代理上当前构建的源代码被克隆到的本地目录绝对路径，不管你配置了多少个工作区映射，它都能稳定给出本地的代码根目录。如果你的构建过程只需要本地路径来定位解决方案文件，这个是最直接的选择。

2. 通过脚本获取首个工作区的服务器端路径 #

如果需要的是源代码管理服务器上的首个工作区映射路径，可以在构建过程中加入一段PowerShell脚本查询工作区信息：

# 加载TFS PowerShell模块（如果代理未预装，可能需要先安装）
Import-Module Microsoft.TeamFoundation.PowerShell

# 获取当前构建对应的工作区对象
$workspace = Get-TfsWorkspace -ServerUri $(System.TeamFoundationCollectionUri) -Path $(Build.Repository.LocalPath)

# 提取首个工作区映射的服务器路径
$firstServerPath = $workspace.Folders[0].ServerItem

# 将结果存入自定义构建变量，方便后续任务调用
Write-Host "##vso[task.setvariable variable=FirstWorkspaceServerPath;]$firstServerPath"

注意：运行这个脚本需要构建代理上安装了TFS PowerShell模块，或者你也可以改用Azure DevOps REST API来查询工作区信息，避免依赖模块。

3. 调整工作区映射简化场景 #

如果你的业务场景允许，建议把核心解决方案的路径设为默认工作区映射，这样$(Build.SourceBranch)就能正常返回对应的分支路径。另外，也可以考虑把不同的工作区映射拆分成独立的构建任务，每个任务对应单一工作区，这样每个任务里的$(Build.SourceBranch)就能准确关联到对应的分支。

4. 用版本号反向查询分支路径 #

如果上述方法都不适用，你还可以用$(Build.SourceVersion)（当前构建的源代码版本号）结合Azure DevOps REST API查询该版本对应的分支信息。不过这个方法步骤稍多，适合特殊场景下使用。

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