Azure DevOps跨组织仓库全分支同步脚本报错排查

问题背景 #

你使用PowerShell脚本同步Azure DevOps两个组织的同名仓库，原脚本仅能同步master分支，修改git fetch命令后出现如下错误：

fatal: refusing to fetch into branch 'refs/heads/master' checked out at '/home/vsts/work/1/s/Polydone.Api'

原脚本存在两个核心问题：

1. 克隆源仓库后本地处于已检出master分支的状态，Git禁止直接向已检出分支执行fetch操作，防止覆盖本地工作区内容
2. 远程仓库配置逻辑混乱：删除源仓库的origin远程后，将目标仓库设为origin，却又去fetch源仓库URL，完全不符合同步逻辑

解决方案1：使用裸仓库同步（推荐，流水线友好） #

裸仓库没有工作区，不会出现分支检出冲突，是Git跨仓库全量同步的标准方式，可同步所有分支和标签：

<#
.SYNOPSIS
    同步Azure DevOps组织间的仓库（全部分支+标签）
.DESCRIPTION
    使用裸仓库方式完成Azure DevOps两个组织下同名仓库的全量同步
#>

Clear-Host

# 定义参数与路径
$repoName = "$(API_Repo)"
$bareRepoPath = "$(System.DefaultWorkingDirectory)\$repoName-bare"
$sourceRepoUrl = "https://$(SourceOrg):$(PAT)@dev.azure.com/$(SourceOrg)/$(URLSourceProject)/_git/$repoName"
$destRepoUrl = "https://$(DestinationOrg):$(PAT)@dev.azure.com/$(DestinationOrg)/$(DestinationProject)/_git/$repoName"

# 清理旧的临时裸仓库
if (Test-Path $bareRepoPath -PathType Container) {
    Remove-Item $bareRepoPath -Recurse -Force
    Write-Output "已清理旧临时裸仓库：$bareRepoPath"
}

# 克隆源仓库为裸仓库
Set-Location "$(System.DefaultWorkingDirectory)"
Write-Output "***** 克隆源仓库为裸仓库 *****"
git clone --bare $sourceRepoUrl

# 配置目标仓库远程并推送全量内容
Set-Location $bareRepoPath
Write-Output "***** 配置目标仓库远程 *****"
git remote add destination $destRepoUrl

Write-Output "***** 推送全部分支到目标仓库 *****"
git push destination --all -f

Write-Output "***** 推送所有标签到目标仓库 *****"
git push destination --tags -f

# 清理临时裸仓库（可选，流水线环境建议保留避免重复克隆）
Set-Location "$(System.DefaultWorkingDirectory)"
Remove-Item $bareRepoPath -Recurse -Force
Write-Output "同步完成，已清理临时资源"

解决方案2：修改原脚本，切换至分离HEAD状态 #

如果必须基于原脚本改造，可通过切换到分离HEAD状态避免分支检出冲突，同时修正远程仓库配置逻辑：

<#
.SYNOPSIS
    同步Azure DevOps组织间的仓库（全部分支）
.DESCRIPTION
    基于原脚本改造，解决分支同步不全与fetch错误问题
#>

Clear-Host

# 清理旧仓库目录
$repoPath = "$(System.DefaultWorkingDirectory)\$(API_Repo)\"
if (Test-Path $repoPath -PathType Container) {
    Remove-Item $repoPath -Recurse -Force
    Write-Output "已清理旧仓库目录：$repoPath"
}

# 定义仓库地址
$sourceRepoUrl = "https://$(SourceOrg):$(PAT)@dev.azure.com/$(SourceOrg)/$(URLSourceProject)/_git/$(API_Repo)"
$destRepoUrl = "https://$(DestinationOrg):$(PAT)@dev.azure.com/$(DestinationOrg)/$(DestinationProject)/_git/$(API_Repo)"

# 克隆源仓库
Set-Location "$(System.DefaultWorkingDirectory)"
Write-Output "***** 克隆源仓库 *****"
git clone $sourceRepoUrl

# 进入仓库目录，切换到分离HEAD状态
Set-Location $repoPath
Write-Output "***** 切换到分离HEAD状态 *****"
git checkout $(git rev-parse HEAD)

# 配置源仓库远程，拉取所有分支
Write-Output "***** 拉取源仓库全部分支 *****"
git remote add source $sourceRepoUrl
git fetch source --all

# 配置目标仓库远程，推送所有分支
Write-Output "***** 推送全部分支到目标仓库 *****"
git remote add destination $destRepoUrl
git push destination --all -f
git push destination --tags -f

关键说明 #

• 方案1的裸仓库方式更稳定，无工作区干扰，适合流水线自动化场景
• 两种方案均添加了标签同步逻辑（--tags），如果不需要可删除对应命令
• 使用-f参数是为了强制覆盖目标仓库的分支历史，确保与源仓库完全一致，若不需要强制覆盖可移除-f

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