♨️【Git 黑科技！】历史记录凭空消失？教你彻底“抹除”早期提交，连 GitHub 都查不到！

✨ Yumuing 博客

🚀 探索技术的每一个角落，解码世界的每一种可能！

💌 如果你对 AI 充满好奇，欢迎关注博主，订阅专栏，让我们一起开启这段奇妙的旅程！

完整操作步骤

该操作常常用于拆分 git 代码仓库的历史版本，或者删除 git 早期包含敏感信息的提交。

1. 确定目标提交的哈希

假设你要保留从提交 C（哈希为 abc123）开始的历史，并删除 C 之前的所有提交。
使用以下命令查找目标提交哈希：

git log --oneline
# 或使用图形化工具（如 GitKraken、SourceTree）

---

2. 切断目标提交的父链接

使用 git replace 临时将提交 C 的父提交（即之前的历史）切断，使其成为新的根提交：

git replace --graft abc123

• --graft 参数：表示“嫁接”，即修改提交的父提交。此处将提交 C 的父提交设置为空（无父提交）。

---

3. 验证替换后的历史

查看替换后的提交树，确认 abc123 是否成为新的起点：

git log --oneline abc123

• 如果成功，提交 C 将显示为根提交，不再包含之前的提交历史。

---

4. 永久化历史修改

使用 git filter-branch 将替换操作应用到所有分支和标签：

git filter-branch -- --all

• --all：覆盖所有分支和标签的提交历史。
• 原理：filter-branch 会遍历每个提交，并根据 git replace 的修改重写历史。

---

5. 清理临时引用

删除 git filter-branch 生成的备份引用（位于 refs/original/）：

git for-each-ref --format="%(refname)" refs/original/ | xargs -n 1 git update-ref -d

---

6. 清理仓库垃圾数据

回收存储空间并删除旧数据：

git reflog expire --expire=now --all
git gc --prune=now

---

7. 强制推送到远程仓库

更新远程仓库的历史（需谨慎操作）：

git push --force --all
git push --force --tags

---

关键注意事项

1. git filter-branch 已被弃用
   官方建议使用更安全的 git filter-repo（需单独安装）。若可用，替代命令如下：

   git filter-repo --commit-callback '
       if commit.original_hash == b"abc123":
           commit.parents = []
   ' --force
   

   • 优点：速度更快、更安全，且默认清理备份引用。

2. 哈希值的变化

   • 使用 git replace 后，目标提交 C 的哈希值暂时不变。
   • 执行 git filter-branch 后，C 及其后续提交的哈希值会改变（因为父提交被修改）。

3. 协作影响

   • 所有协作者需重新克隆仓库，否则本地历史与远程不一致。
   • 若仓库有保护分支，需临时解除保护才能强制推送。

---

操作流程图解

原始提交链：A → B → C → D→ E （需删除 A 和 B）
操作后提交链：C → D → E （C 成为根提交）

常见问题

Q1: 执行 git filter-branch 时报错或卡住？

• 原因：仓库历史复杂或提交数量过多。
• 解决：改用 git filter-repo，或分步操作（如指定单个分支 git filter-branch HEAD）。

Q2: 如何恢复误操作？

• 恢复方法：操作前备份仓库（克隆副本或创建备份分支）。若未备份，可通过 git reflog 查找旧提交哈希手动恢复。

Q3: 是否会影响未推送的本地提交？

• 影响范围：git filter-branch 会修改所有本地分支的历史，建议在操作前提交或暂存所有工作。
• 代码影响：由于 git 提交操作都为快照类型，即每条提交历史都包含所有代码修改，所以，如果没有删除最新提交记录，将不会影响最新代码情况

---

总结

此方法通过 git replace 临时修改提交关系，再通过 git filter-branch 永久化变更，适合需要保留目标提交哈希后续历史的场景。但因其复杂性，推荐优先使用 git filter-repo 替代。操作前务必备份仓库！