作为多年的后端开发工程师，我一直使用Git远程仓库来管理我的技术笔记。最近，原来的代码仓库管理平台停止服务了，所以想将代码迁移到新的代码仓库管理平台。

20250907还可以，第二天刚限制不能提交代码：

无奈只能迁移到新平台了

一、迁移需求

Git迁移的核心在于保证数据完整性，本次需求如下：

• 将本地仓库完整迁移到新平台，保留所有的Git提交历史。
• 确保分支、标签和LFS文件都能正常迁移
• 本地未推送的更改也要一并迁移

二、迁移方案

我面临的问题：
1、原远程仓库已经下线，但本地仓库还有未推送的更改。
2、需要将本地仓库的完整历史（包括所有分支和标签）推送到新的远程仓库。

根据新仓库平台提供的官方迁移方案，我最初尝试官方推荐方案（裸库迁移）：

mkdir empty && cd empty
git clone --bare https://e.coding.net/kunggewan/mynote/mynote.git .
git lfs fetch origin --all
git push --mirror https://cnb.cool/KunWanTech/MyNote

但由于原仓库已经下线，这个方案无法执行。

新的迁移方案，就是使用本地的仓库，因为本地仓库可能还保留着原远程仓库的所有分支和标签。

三、迁移步骤

3.1 准备工作

进入本地仓库目录，确保所有更改已提交：

cd /path/to/mynote
git status
git add .
git commit -m "迁移前的最终提交"

迁移前务必备份本地仓库，备份整个仓库目录到安全位置：

cp -r /Users/wankun/mynote /Users/wankun/test/backup/mynote-backup

检查所有分支和标签：

git branch -a
git tag

3.2 添加新远程仓库

如果是公共仓库（无认证），直接设置：

git remote add neworigin https://xxxxxx/MyNote.git

如果是私有仓库，需要设置用户名和密码：

git remote set-url neworigin https://{userName}:{token}@cnb.cool/KunWanTech/MyNote.git

验证远程仓库添加成功，使用 git remote -v

一定要正确的仓库地址，确保包含.git后缀。

如果要修改远程仓库地址，可以先删除错误的远程仓库，使用命令：git remote remove neworigin，再按上面步骤添加即可。

3.3 推送代码

使用如下命令：

# 推送所有分支（包括提交历史）
git push neworigin --all

# 推送所有标签
git push neworigin --tags

# 如果使用Git LFS，推送LFS对象
git lfs push neworigin --all

3.4 迁移结果验证

主要验证：

• 分支：所有本地分支都推送到远程
• 标签：所有标签完整迁移
• 提交历史：Git日志完整无缺失
• 文件内容：所有文件内容正确无误
• LFS文件：大文件正常显示

进入仓库首页，文件、分钟都迁移正常：

提交历史正常：

四、相关问题解决

推送代码的时候，如果提示如下错误：

Enumerating objects: 6750, done.
Counting objects: 100% (6750/6750), done.
Delta compression using up to 4 threads
Compressing objects: 100% (4668/4668), done.
send-pack: unexpected disconnect while reading sideband packet
Writing objects: 100% (6750/6750), 10.97 MiB | 13.91 MiB/s, done.
Total 6750 (delta 3567), reused 3867 (delta 1765), pack-reused 0
fatal: the remote end hung up unexpectedly
Everything up-to-date

错误信息：the remote end hung up unexpectedly。

这是一个典型的网络传输问题，可能原因包括：

• 网络连接不稳定
• Git缓冲区大小不足
• 服务器对单次推送大小有限制
• 网络超时

在迁移大型Git仓库时，这种问题常见，通过调整Git的缓冲区大小和启用压缩，可以有效地解决这类问题。
增加Git缓冲区大小（推荐首选）

# 设置更大的postBuffer
git config http.postBuffer 524288000  # 500MB

# 重新推送
git push neworigin --all

已经推送成功了：

如果上面的方法还不能解决，还可以尝试使用SSH方式推送、分批推送或使用Git bundle等方法，有兴趣的朋友可以自行尝试。

五、总结

这次Git仓库迁移虽然遇到了一些技术挑战，但通过系统性的问题分析和逐步解决，最终成功完成了迁移。这个过程再次证明了理解工具原理和系统化解决问题的重要性。希望此文能够帮助遇到类似问题的网友顺利完成仓库迁移。