博客站

Git仓库迁移是开发团队常会遇到的任务，无论是更换代码托管平台、服务器迁移还是项目重组，都需要确保迁移过程中不丢失任何代码历史、分支和标签。下面将详细介绍完整迁移Git仓库的专业方法。

一、准备工作

1. 确认源仓库信息

   git remote -v  # 查看当前远程仓库
   git branch -a  # 查看所有分支
   git tag        # 查看所有标签
   

2. 在目标平台创建空仓库

   • GitHub/GitLab/Bitbucket等平台创建新仓库
   • 不要初始化README/.gitignore等文件

二、完整迁移步骤

方法1：使用git clone --mirror（推荐）

# 克隆源仓库（包含所有分支、标签和历史）
git clone --mirror 原仓库URL

# 进入克隆的仓库目录
cd 原仓库.git

# 推送到新仓库
git push --mirror 新仓库URL

方法2：手动迁移

# 克隆源仓库
git clone 原仓库URL
cd 原仓库

# 获取所有远程分支
git fetch --all

# 添加新远程仓库
git remote add new-origin 新仓库URL

# 推送所有分支
git push --all new-origin

# 推送所有标签
git push --tags new-origin

三、迁移后验证

1. 检查分支和标签

   git branch -a
   git tag
   

2. 验证提交历史

   git log --oneline --graph --all
   

3. 测试代码检出

   cd /tmp
   git clone 新仓库URL
   

四、高级场景处理

1. 迁移包含LFS文件的仓库

   git lfs fetch --all
   git lfs push --all 新仓库URL
   

2. 迁移子模块

   • 需要单独迁移每个子模块仓库
   • 更新主仓库中的子模块引用

3. 大型仓库迁移优化

   git repack -a -d --window=250 --depth=250
   

五、常见问题解决

1. 认证失败

   • 检查SSH密钥或访问令牌
   • 使用HTTPS时配置凭证存储

2. 分支/标签冲突

   git push --mirror -f  # 强制覆盖（谨慎使用）
   

3. 网络中断

   git config --global http.postBuffer 524288000  # 增大缓冲区
   

六、最佳实践

1. 在非高峰期执行迁移
2. 提前通知团队成员暂停提交
3. 保留源仓库一段时间作为备份
4. 更新CI/CD流水线中的仓库地址
5. 通知所有协作者更新本地仓库remote

通过以上步骤，您可以确保Git仓库的完整迁移，保留所有有价值的历史记录和元数据。根据仓库大小和网络条件，迁移过程可能需要几分钟到数小时不等。对于特别大的仓库，考虑使用Git bundle或分阶段迁移的方法。

提示：迁移完成后，别忘了更新项目文档中的仓库地址，并考虑在源仓库设置重定向通知。