完美转移Git仓库，保全所有提交历史：实战教程

背景介绍

最近在项目开发中遇到一个问题，需要将老git仓库中的部分或者全部分支迁移到另外一个新的仓库对应的分支上，并且需要保存老仓库分支的提交记录。网上的方案踩坑不少，经过实战发现了简单有效的操作方式，大家放心食用。

操作步骤

1. clone老仓库
   $ git clone <仓库地址>
   

   

   image.png
   
   clone后可以看到我们仓库名的名字是test_branch_1，进入该目录
   $ cd test_branch_1

2. git fetch同步修改记录

   
   
   

   image.png

3. 添加新仓库地址

   • 首先确认下已有仓库别名信息，使用git remote -v进行查看
     $ git remote -v
     
     

     image.png

• 添加新仓库别名己地址信息
  git remote add new_origin <新仓库地址>
  添加后再次使用git remote -v命令即可查看新的别名及仓库是否设置成功
  
  

  image.png

4. 提交老仓库某个分支信息到新仓库某个分支

   • 需要同步老仓库的分支必须要在本地checkout过，即本地存在过和远程对应的分支（例如现在需要迁移dev3的分支记录到新仓库的develop_3分支，那么dev3这个分支本地必须有同名或者关联到dev3不同名的均可以）
     $ git checkout dev3
   • 同步最新提交记录
     $ git fetch
   • 提交到新仓库对应分支下
     $ git push new_origin dev3:develop_3
     
     

     image.png
     
     此处是将老仓库的dev3分支的所有记录同步到新仓库的develop_3的分支上，此时如果新仓库没有develop_3那么将会新建一个。但如果分支已经存在且有提交记录的话，可能会提交不成功，会出现如下信息
     
     

     image.png
     
     此时需要确认是否需要忽略已有提交，如果是的话可以使用--force命令进行强制提交，会将之前的记录全部覆盖，导致之前的记录不存在，需要谨慎使用
     $ git push --force new_origin dev_2:develop_2
     
     

     image.png

5. 所有老仓库分支及记录同步到新仓库

   • 使用git push new_origin --all即可推送所有在本地仓库的提交记录到新仓库名为new_origin的地址上。此方式如果新仓库有同名的分支名，默认不会推送，未重名的则会直接推送，此处可以看见dev3推送成功，dev4由于存在未进行同步关联，故无法推送成功。

     
     
     

     image.png

   • 如果想强制覆盖新仓库的同名分支，则可以使用--force命令。使用后将会强制覆盖新仓库同名的分支所有提交记录，谨慎使用

     
     
     

     image.png

6. 所有老仓库tag同步到新仓库

   • 使用git push new_origin --tags即可推送老仓库的所有tags到新仓库中，注意事项和第五点相同

mirror方式推送更新

1. 使用bare的方式克隆老仓库
   git clone --bare <老仓库地址>

2、镜像push到新仓库地址

$ cd old-repository.git  
$ git push --mirror <新仓库地址>

3、删除老仓库（可选）

$ cd ..
$ rm -rf old-repository.git

注意该方式会将新仓库所有其他分支全部删除，只保留老仓库的分支，适用于老仓库换地址迁移，不适用于迁移到新仓库已经有其他分支的场景

其他：

1. 使用git clone <地址> --bare或者--mirror可以自动在本地库中创建所有remote分支信息，不需要一个个checkout，适用于分支较多的场景。
2. mirror和bare的区别在于mirror保留了远程跟踪分支，注释等并设置refspec配置，mirror主要用于仓库备份，后续可以使用git fetch、git remote update方便进行更新remote操作.