Azure DevOps同步Github时已删除分支无法同步问题排查

开发者阿泽

2026-8-29

问题诱因

核心逻辑缺陷：git push secondary --all 仅会推送本地存在的全部分支，不会主动删除Github端存在、但本地已不存在的分支，这是分支删除操作无法同步的根本原因。
你新增的两行代码完全没有达到预期效果：
1. git remote prune $sourceUrl 命令无效：git remote prune 仅对已在本地配置的命名远端生效，直接传入URL字符串无法触发prune逻辑；且你每次执行脚本都会清空本地目录重新克隆，本地引用本来就是和Azure DevOps完全一致的最新状态，根本不需要额外prune操作。
2. 调用grep/awk/xargs的本地分支清理命令兼容性极差：PowerShell环境默认不集成这些Linux原生命令，就算环境支持执行成功，在push命令未加对应参数的前提下，依然不会触发Github端的分支删除。
冗余配置不生效：你给secondary远端配置了--mirror=fetch属性，但push时使用--all参数，完全没有用到mirror同步逻辑，该配置没有实际作用。

修复方案

要实现包含分支删除、标签删除在内的全量镜像同步，直接使用git原生的mirror推送模式即可：该模式会将本地仓库的所有引用（分支、标签、提交记录）完全同步到目标远端，自动删除目标端存在、本地不存在的引用，完全匹配双端完全同步的需求。

前置权限确认：确保Github侧使用的PAT拥有repo范围的完整权限（必须包含删除分支的操作权限，不要仅勾选内容写入权限）。
移除原有无效的prune、本地分支清理代码，将push命令从git push secondary --all替换为git push secondary --mirror。

修正后的完整PowerShell脚本逻辑如下：

$stageDir = "$(Build.SourcesDirectory)" | Split-Path
$githubDir = "${stageDir}/gitHub"
$destination = "${githubDir}/${repoName}.git"
$sourceURL = "https://$(AzureDevOps.PAT)@dev.azure.com/${azureOrganization}/${repoName}/_git/${repoName}"
$destURL = "https://${githubUsername}:$(Github.PAT)@github.com/${githubUsername}/${repoName}.git"

if((Test-Path -path $githubDir))
{
  Remove-Item -Path $githubDir -Recurse -force
}

if(!(Test-Path -path $githubDir))
{
  New-Item -ItemType directory -Path $githubDir
  Set-Location $githubDir
  git clone --mirror $sourceURL
}
Set-Location $destination

git remote rm secondary
git remote add secondary $destURL
git push secondary --mirror

Set-Location $stageDir
if((Test-Path -path $githubDir))
{
  Remove-Item -Path $githubDir -Recurse -force
}

如果需要优化流水线执行速度，不想每次全量克隆仓库，可以保留本地缓存目录，每次执行带prune参数的fetch即可，对应逻辑如下：

# 省略目录判断、创建逻辑
Set-Location $destination
# 首次执行时添加两个远端，后续执行直接更新地址即可
if(!(git remote get-url origin)){ git remote add origin $sourceURL }
if(!(git remote get-url secondary)){ git remote add secondary $destURL }
git remote set-url origin $sourceURL
git remote set-url secondary $destURL
git fetch origin --prune
git push secondary --mirror

注意：如果仓库使用了Git LFS存储大文件，需要提前在流水线运行的Agent上安装git-lfs，同步时额外执行git lfs fetch origin --all和git lfs push secondary --all即可完成LFS文件的全量同步。

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