$(Build.SourceVersion)有时返回旧变更集编号，如何获取触发构建的最新编号？

核心结论 #

没法直接强制更新$(Build.SourceVersion)变量，因为它是在构建初始化阶段就锁定的版本快照值。出现返回旧变更集的情况，通常和构建触发逻辑、版本快照时机有关，以下是可行的替代方案：

替代方案 #

1. 检查并调整构建触发规则 #

如果是CI自动触发的构建，先去管道的触发设置里检查「批处理更改（Batch changes while a build is in progress）」选项：

• 若开启该选项，当已有构建在运行时，后续提交会被合并到下一次构建，此时Build.SourceVersion会取合并批次里最早的提交ID
• 关闭该选项后，每个提交都会触发独立构建，Build.SourceVersion就会对应触发本次构建的具体提交

2. 调用Azure DevOps API获取触发构建的变更集 #

在PowerShell任务中执行以下脚本，直接从构建详情里获取触发本次构建的变更记录：

$orgName = "你的组织名称"
$projectName = "你的项目名称"
$buildId = $env:BUILD_BUILDID

$headers = @{
    "Authorization" = "Bearer $env:SYSTEM_ACCESSTOKEN"
    "Content-Type" = "application/json"
}

$apiUrl = "https://dev.azure.com/$orgName/$projectName/_apis/build/builds/$buildId/changes?api-version=7.1-preview.2"
$changes = Invoke-RestMethod -Uri $apiUrl -Headers $headers -Method Get

# 筛选出触发构建的最新提交/变更集
$triggeredChange = $changes.value | Where-Object { $_.trigger -eq $true } | Select-Object -First 1
Write-Host "触发构建的变更集编号: $($triggeredChange.id)"

注意：需要在管道的代理作业设置中勾选「允许脚本访问OAuth令牌」，确保$env:SYSTEM_ACCESSTOKEN能正常获取权限。

3. 通过Git命令直接拉取当前构建的最新变更 #

如果使用Git仓库，可在PowerShell任务中执行Git命令获取当前工作目录的最新提交ID：

# 确保拉取最新代码
git fetch origin
# 获取当前分支的最新提交ID
$latestCommitId = git rev-parse HEAD
Write-Host "当前构建对应的变更集编号: $latestCommitId"

若代理工作目录存在缓存，可先执行git clean -fd清除旧文件后再拉取。

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