将 Gitee 仓库迁移到 GitHub 并保留提交历史的全过程记录

2025-08-05运维1 分钟194 次阅读
AI 摘要salmon-ai

本文详细解析了将 Gitee 仓库迁移到 GitHub 并保留完整提交历史的操作流程,包括在 GitHub 创建空仓库、检查本地远程配置、添加或替换 GitHub 远程地址、推送代码与历史记录

前言

由于某些原因,我不再继续使用 Gitee 作为代码仓库,决定将代码迁移到 GitHub。本文我将记录从 Gitee 仓库完整迁移到 GitHub(包括所有提交历史)的一整套操作流程。

🧠 场景背景

前提准备

  1. 已在 GitHub 创建了一个新的空仓库(不要初始化 README / .gitignore / LICENSE 等)。
  2. 本地已经存在该项目的 Git 仓库(如果不小心删了但还在目录中,可以重新 git init 并连接远程 Gitee 后恢复)。

迁移步骤详解

步骤 1:确认当前仓库状态

bash 复制代码
git remote -v

示例输出:

bash 复制代码
origin  https://gitee.com/salmon0614/xxxxx.git (fetch)
origin  https://gitee.com/salmon0614/xxxxx.git (push)

步骤 2:将 GitHub 添加为新的远程地址

bash 复制代码
git remote set-url origin https://github.com/Salmon0614/xxxxx.git

或者如果你想保留 Gitee 地址,也可以添加 GitHub 为另一个别名:

bash 复制代码
git remote add github https://github.com/Salmon0614/xxxxx.git

步骤 3:推送代码及历史到 GitHub

bash 复制代码
git push -u origin master

或者如果使用 github 作为远程名:

bash 复制代码
git push -u github master

这将把本地代码和提交历史完整推送到 GitHub。

验证效果

前往 https://github.com/Salmon0614/xxxxx,查看所有历史提交记录、分支等是否成功迁移。

移除 Gitee 远程地址(可选)

如果不再需要保留 Gitee 的远程地址,可以移除:

bash 复制代码
git remote remove origin

或者如果你用了 github 作为新地址,保留 origin 也没问题,建议规范远程命名即可。

最终结果

  • 本地代码成功推送到了 GitHub。
  • 所有历史提交记录(包括提交人、时间、信息)完整保留。
  • 之后的开发将基于 GitHub 仓库继续。

小提示:避免非 fast-forward 错误

在推送前,如果远程仓库已有不同的提交,可能会出现如下错误:

bash 复制代码
! [rejected] master -> master (non-fast-forward)
error: failed to push some refs

这表示远程的提交比你本地的更“新”,可以执行如下命令合并:

bash 复制代码
git pull --rebase origin master

但如果你确认本地是最新的,也可以强制推送(注意风险):

bash 复制代码
git push -f origin master
觉得有用就点个赞,不用登录也能读

评论

0 条
登录 之后才能评论
—
还没有评论,来说第一句