3分钟搞定多仓库同步：Windows环境下的Git批量操作脚本
项目地址: https://gitcode.com/gh_mirrors/git/git 你是否还在为管理多个Git仓库而频繁切换目录、重复输入命令？是否希望一键完成所有项目的拉取、推送和更新？本文将带你使用Git原生工具和自定义脚本，在Windows环境下实现多仓库自动化同步，彻底告别繁琐的手动操作。
为什么需要多仓库同步脚本？
在日常开发中，我们经常需要同时维护多个Git仓库。无论是管理微服务项目群、开源项目镜像，还是同步个人代码库，手动操作都面临以下痛点：
- 重复劳动：切换目录、输入命令占用大量时间
- 容易遗漏：手动操作难以保证所有仓库都同步更新
- 版本混乱：不同仓库的分支状态难以统一管理
Git提供了git-submodule.sh工具支持子模块管理，但对于独立仓库的批量操作仍需自定义脚本。下面我们将分步骤实现一个高效的多仓库同步解决方案。
准备工作：环境配置与依赖检查
必要条件
确保系统已安装：
- Git for Windows（建议2.30+版本）
- PowerShell 5.1或更高版本（Windows 10/11自带）
仓库准备
- 创建工作目录并克隆基础仓库：
mkdir C:\GitRepos
cd C:\GitRepos
git clone https://gitcode.com/gh_mirrors/git/git
- 创建仓库列表文件
repos.txt，每行一个仓库路径：
C:\GitRepos\git
C:\GitRepos\project1
C:\GitRepos\project2
核心实现：Windows批量同步脚本
基础版脚本：同步所有仓库
创建Sync-GitRepos.ps1文件，实现基本的拉取和推送功能：
# 读取仓库列表
$repos = Get-Content "C:\GitRepos\repos.txt"
foreach ($repo in $repos) {
Write-Host "`n=== 处理仓库: $repo ===" -ForegroundColor Cyan
# 检查目录是否存在
if (-not (Test-Path "$repo\.git")) {
Write-Warning "跳过非Git仓库: $repo"
continue
}
# 拉取最新代码
Set-Location $repo
git pull --rebase
# 推送本地分支
git push
# 检查子模块
if (Test-Path "$repo\.gitmodules") {
Write-Host "更新子模块..." -ForegroundColor Yellow
git submodule update --init --recursive
}
}
Set-Location C:\GitRepos
Write-Host "`n=== 所有仓库同步完成 ===" -ForegroundColor Green
增强版脚本：添加错误处理与报告
$logFile = "C:\GitRepos\sync_log_$(Get-Date -Format 'yyyyMMdd').txt"
$successCount = 0
$failCount = 0
$failRepos = @()
# 记录日志函数
function Log-Message {
param([string]$message, [bool]$isError = $false)
$timestamp = Get-Date -Format 'HH:mm:ss'
$logEntry = "[$timestamp] $message"
if ($isError) {
Write-Host $logEntry -ForegroundColor Red
$logEntry | Out-File -FilePath $logFile -Append -Encoding utf8
$script:failCount++
$script:failRepos += $repo
}
else {
Write-Host $logEntry
$logEntry | Out-File -FilePath $logFile -Append -Encoding utf8
$script:successCount++
}
}
# 主同步逻辑
$repos = Get-Content "C:\GitRepos\repos.txt"
Log-Message "=== 开始多仓库同步 ==="
foreach ($repo in $repos) {
Log-Message "处理仓库: $repo"
try {
if (-not (Test-Path "$repo\.git")) {
Log-Message "跳过非Git仓库: $repo"
continue
}
Set-Location $repo
# 拉取更新
$pullOutput = git pull --rebase 2>&1
if ($LASTEXITCODE -ne 0) {
throw "拉取失败: $($pullOutput -join '; ')"
}
# 推送更新
$pushOutput = git push 2>&1
if ($LASTEXITCODE -ne 0) {
throw "推送失败: $($pushOutput -join '; ')"
}
# 更新子模块
if (Test-Path ".gitmodules") {
git submodule sync
git submodule update --init --recursive
}
Log-Message "仓库同步成功: $repo"
}
catch {
Log-Message "仓库同步失败: $repo - $($_.Exception.Message)" $true
}
}
# 生成报告
Log-Message "`n=== 同步完成 ==="
Log-Message "成功: $successCount 个仓库"
Log-Message "失败: $failCount 个仓库"
if ($failRepos.Count -gt 0) {
Log-Message "失败仓库: $($failRepos -join ', ')" $true
}
# 打开日志文件
Start-Process notepad.exe $logFile
高级功能：定制化同步策略
按分支同步
修改脚本添加分支过滤功能，只同步特定分支：
# 添加分支参数
param(
[string]$branch = "main"
)
# 在git pull前添加分支检查
git checkout $branch
if ($LASTEXITCODE -ne 0) {
throw "切换到 $branch 分支失败"
}
定时自动同步
通过Windows任务计划程序设置定时执行：
- 按下
Win + R，输入taskschd.msc打开任务计划程序 - 创建基本任务，设置触发器（如每天凌晨3点）
- 操作选择"启动程序"，程序路径为
powershell.exe - 参数填写
-File "C:\GitRepos\Sync-GitRepos.ps1"
常见问题与解决方案
权限问题
症状：脚本执行时报"拒绝访问"错误
解决：
- 以管理员身份运行PowerShell
- 检查仓库目录权限
- 执行以下命令设置执行策略：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
网络超时
症状：git pull命令经常卡住
解决：
- 配置Git超时设置：
git config --global http.timeout 300
git config --global https.timeout 300
- 在脚本中添加重试机制：
# 带重试的拉取函数
function Invoke-GitPullWithRetry {
param($maxRetries = 3)
$retryCount = 0
do {
git pull --rebase
if ($LASTEXITCODE -eq 0) { return $true }
$retryCount++
Write-Warning "重试第 $retryCount 次..."
Start-Sleep -Seconds 5
} while ($retryCount -lt $maxRetries)
return $false
}
总结与扩展方向
本文介绍的多仓库同步方案基于Git原生工具和PowerShell脚本，具有以下优势：
- 轻量级：无需额外安装依赖
- 可定制：根据需求修改同步策略
- 易维护：脚本逻辑清晰，便于扩展
未来可以进一步扩展：
- 添加邮件通知功能，同步失败时自动发送报告
- 实现仓库健康检查，检测大文件、分支数量等指标
- 集成Git LFS支持，处理大型二进制文件
希望这个方案能帮助你更高效地管理多个Git仓库，减少重复劳动，专注于更有价值的开发工作！如果觉得有用，请收藏本文并分享给同事。
下一篇我们将介绍"跨平台Git钩子脚本开发"，敬请期待！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
