Git 断根创建新仓库并迁移到 Gitea#
背景#
场景：
- 原仓库历史较长，不希望保留全部提交历史
- 希望从某个历史 Commit 开始作为新的仓库起点
- 保留该 Commit 对应的代码状态
- 后续提交继续保留（通过 Cherry-pick）
- 最终推送到 Gitea 新仓库
例如：
A → B → C → D(a13ad8e0) → E → F → G目标：
INIT → E' → F' → G'其中：
INIT为新的根提交- 历史从
a13ad8e0开始重建 - 丢弃
a13ad8e0之前的所有历史
1. 切换到目标 Commit#
例如：
git checkout a13ad8e0此时会进入 Detached HEAD 状态：
HEAD is now at a13ad8e0 ...这是正常现象。
2. 创建 Orphan 分支#
创建一个没有任何历史的新分支：
git checkout --orphan gitea-fastpixel或者：
git switch --orphan gitea-fastpixel检查状态：
git status正常会看到：
On branch gitea-fastpixel
No commits yet
Changes to be committed:
new file: ...说明：
- Git 历史为空
- 工作区内容来自
a13ad8e0 - 所有文件准备作为新的初始提交
3. 创建新的根提交#
提交当前代码：
git commit -m "feat: init fastpixel"如果 Pre-commit 修改了文件：
git add .
git commit -m "feat: init fastpixel"如果被大文件检查拦截：
SKIP=check-added-large-files git commit -m "feat: init fastpixel"验证：
git log --oneline此时应该只看到：
xxxxxxxx feat: init fastpixel这就是新的根提交。
4. Cherry-pick 后续提交#
原分支：
1d7b8003
917000a4
88096330
656ecc94
a4c4b2ef
b2da68d7
9b9e9e2d
be07d678
5ac51f63
a13ad8e0查看需要同步的提交：
git log --oneline --reverse a13ad8e0..fastpixel结果：
5ac51f63
be07d678
9b9e9e2d
...
1d7b8003执行：
git cherry-pick a13ad8e0..fastpixel等价于：
Cherry-pick:
5ac51f63
be07d678
9b9e9e2d
...
1d7b8003不包含：
a13ad8e0因为它已经作为新的根提交存在。
5. 处理冲突#
如果出现冲突：
查看状态：
git status解决冲突后：
git add .
git cherry-pick --continue放弃整个过程：
git cherry-pick --abort6. 修改主分支名称#
Gitea 推荐使用 main：
git branch -m main验证：
git branch输出：
* main7. 创建 Gitea 仓库#
在 Gitea 中创建新仓库：
Repository Name:
fastpixel推荐配置：
Object Format: SHA-1不要勾选：
☐ README
☐ License
☐ .gitignore保持空仓库。
8. 保留公司远程仓库#
查看当前 Remote：
git remote -v例如：
origin ssh://company.git改名：
git remote rename origin company验证：
git remote -v结果：
company ssh://company.git9. 添加 Gitea Remote#
例如：
git remote add origin git@gitea.home:clloz/fastpixel.git验证：
git remote -v结果：
company ssh://company.git
origin git@gitea.home:clloz/fastpixel.git10. 推送到 Gitea#
首次推送：
git push -u origin main成功后：
Branch 'main' set up to track remote branch 'main'11. 验证历史#
查看完整历史：
git log --oneline --graph --decorate结果类似：
* 1d7b8003 refactor: ...
* 917000a4 docs: ...
* 88096330 build: ...
...
* xxxxxxxx feat: init fastpixel确认：
- 旧历史已断开
- 保留指定 Commit 之后的提交
- Gitea 仓库历史干净
常用命令#
查看将要 Cherry-pick 的提交#
git log --oneline a13ad8e0..fastpixel按时间顺序：
git log --oneline --reverse a13ad8e0..fastpixel查看所有分支关系#
git log --oneline --graph --decorate --all删除错误创建的分支#
git branch -D gitea-fastpixel取消暂存#
git rm --cached -r .仅移除暂存区，不删除文件。
最终流程#
git checkout a13ad8e0
git checkout --orphan gitea-fastpixel
git commit -m "feat: init fastpixel"
git cherry-pick a13ad8e0..fastpixel
git branch -m main
git remote rename origin company
git remote add origin git@gitea.home:clloz/fastpixel.git
git push -u origin main