将 Gitee 仓库迁移到 GitHub 并保留提交历史的全过程记录
AI 摘要salmon-ai
本文详细解析了将 Gitee 仓库迁移到 GitHub 并保留完整提交历史的操作流程,包括在 GitHub 创建空仓库、检查本地远程配置、添加或替换 GitHub 远程地址、推送代码与历史记录
前言
由于某些原因,我不再继续使用 Gitee 作为代码仓库,决定将代码迁移到 GitHub。本文我将记录从 Gitee 仓库完整迁移到 GitHub(包括所有提交历史)的一整套操作流程。
🧠 场景背景
- 原仓库(Gitee):https://gitee.com/salmon0614/xxxxx.git
- 新仓库(GitHub):https://github.com/Salmon0614/xxxxx.git
- 目标:将原有 Gitee 仓库中的所有代码和历史提交记录完整迁移到 GitHub,并后续使用 GitHub 管理。
前提准备
- 已在 GitHub 创建了一个新的空仓库(不要初始化 README / .gitignore / LICENSE 等)。
- 本地已经存在该项目的 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 条—
还没有评论,来说第一句