覆盖提交不等于删除，这才是彻底清除 Git 历史的正确姿势

作者：村雨遥

不要哀求，学会争取，若是如此，终有所获

原文：mp.weixin.qq.com/s/kTXYzdcK5…

一、前言

在使用 Git 管理代码或文档时，难免会因手滑将大文件或敏感信息（密钥、凭证、个人隐私数据等）一并提交到仓库。虽然可以通过后续提交"覆盖"这些内容，但 Git 的提交历史会永久保留每一次变更。

这意味着，只要仓库被他人访问，任何人都可能通过历史记录轻松还原这些敏感信息。

⚠️ 安全提示：覆盖提交只是让最新版本看不到敏感内容，历史记录里它依然原封不动地躺着。这才是真正的安全隐患。

那么，有没有办法彻底清除 Git 的历史提交记录，在风险暴露之前"抹除"这些痕迹？本文将系统性介绍三种方案，帮助你有效保护项目安全。

---

二、三种方案速览

正式开始前，先通过一张表快速了解三种方案的区别，方便你按需选择：

方案	工具/命令	适用场景	是否保留其他历史	风险等级
删除指定提交	git rebase -i	只需删某几次提交，其他记录保留	✅ 保留	中
删除大文件/敏感文件	git-filter-repo	只删特定文件，提交结构不变	✅ 保留	中
清除所有历史	git checkout --orphan	需要从头开始，彻底重置	❌ 全部丢弃	高

三种方案都会改写 Git 历史，且都需要 --force 强制推送才能生效。操作前请务必备份仓库，并与团队成员充分沟通。

---

三、操作前检查清单

在执行以下任何方案之前，请逐项确认：

• 已备份仓库（git clone --mirror 克隆一份镜像副本）。
• 已通知协作团队，确认没有正在进行的 PR/MR 依赖旧历史。
• 操作分支不是 main/master 的唯一工作副本。
• 确认仓库当前没有未提交的更改。

---

四、清除方案

假设我们已有仓库 git-repo，其中曾误提交敏感信息和大文件，当前仓库结构如下：

.
├── 1.txt
├── bigfile.zip
├── HelloWorld.java
└── 身份证.txt

提交历史如下：

e9f4279 (HEAD -> main, origin/main) Hello World
dec50cc 提交大文件
17c88c5 提交身份证信息
f0796ef init commit

4.1 删除指定的提交

适用场景：只想删除历史中的某一次或多次提交，同时保留其他记录。

若只想删除历史中的某一次或多次提交，同时保留其他记录，可使用交互式变基。

首先，查看提交记录，以此定位需要删除的目标提交的父提交 ID。

git log --oneline

假设要删除提交身份证的那次提交记录，则从该提交的父节点开始交互式变基。

git rebase -i f0796ef

此时终端中会弹出文本编辑器，将需要删除的提交记录的 pick 修改为 drop。如果需要删除多次提交，则修改对应提交记录，然后保存退出即可。

最后，将修改强制推送到远程即可实现指定提交记录的删除。推送完成后再看提交记录，就会发现提交敏感信息的提交已经成功删除。

git push origin main --force

注意：交互式 rebase 适合提交尚未被广泛共享的场景。如果是多人协作的活跃仓库，rebase 改写历史后其他成员拉取时可能出现冲突，需谨慎使用并提前沟通。

4.2 删除大文件/敏感文件

适用场景：只想从整个历史中彻底移除特定文件（大文件、密钥等），而不改变提交结构和次数。

假设要删除仓库中误提交的大文件 bigfile.zip，可使用 git-filter-repo 工具。

首要的，安装该工具（需要 Python 3.5+），不同系统下的安装命令如下：

# Windows/Linux（需要 Python 3.5+）
pip install git-filter-repo
# macOS
brew install git-filter-repo

安装完成之后，可以使用如下命令对仓库进行分析，看看是哪些文件占用了大量空间。分析完成后会在当前仓库的 .git/filter-repo/analysis/ 目录生成对应报告。

git filter-repo --analyze

紧接着，先备份下仓库。

git clone --mirror https://github.com/cunyu1943/git-repo backup-repo.git

然后就可以将大文件删除。当然了，如果想删除某个目录，也是支持的。甚至你还可以使用通配符模式、文件大小等来进行删除。

# 删除历史中所有的 bigfile.zip 文件
git filter-repo --invert-paths --path bigfile.zip
# 执行后会输出：Parsed X commits, replayed X commits, removed bigfile.zip

# 删除历史中整个目录，例如 node_modules
git filter-repo --invert-paths --path node_modules/

# 删除所有提交记录中的 .zip 文件
git filter-repo --invert-paths --path-glob "*.zip"

# 根据大小删除，大于 10MB 即删除
git filter-repo --strip-blobs-bigger-than 10M

最后，强制推送覆盖远程仓库内容即可。不过 filter-repo 会自动将远程仓库配置移除，强制推送前得重新添加配置才能成功。这时候再去查看仓库，可以发现大文件已经不复存在了。

git remote add origin <你的远程仓库URL>
git push origin --force --all   # 推送所有分支
git push origin --force --tags  # 推送所有标签

4.3 清除所有提交历史

适用场景：想要让仓库从头开始，彻底抹除之前的所有提交记录。

如果想要让仓库从头开始，彻底抹除之前的所有提交记录，那这时候可以使用 Git 孤立分支 --orphan 来实现。

首先，备份下仓库的当前分支。

git branch backup-main

接着，创建无提交记录的孤立分支。然后把原来仓库中的大文件/敏感信息删除后，将所有代码作为初始提交即可。

git checkout --orphan fresh
git add .
git commit -m "重建提交"

删除原来的旧分支 main，然后将重建的分支 fresh 重命名为 main 即可。

# 删除旧的主分支
git branch -D main
# 将当前干净分支重命名为 main
git branch -m main

最后，将所有信息强制推送到远程分支就可以了。

git push origin main --force --set-upstream

PS：我们在最后一种方式中，其实是创建了本地备份分支的。如果我们确认之前的操作没问题，那本地备份的 main 分支也就没有必要保留了，你可以通过以下方式对其进行删除。

git branch -D backup-main

---

五、常见问题

1. Q：强制推送后，其他人本地怎么同步？

A：其他人需要重置本地分支以匹配远程，因为历史已被改写。执行 git fetch origin 后，用 git reset --hard origin/main 将本地分支重置为远程最新状态。注意这会丢弃本地未提交的更改，务必提前通知团队成员。

2. Q：filter-repo 操作后 remote 消失了怎么办？

这是 git-filter-repo 的默认行为，出于安全考虑它会移除 remote 配置。重新添加即可：

git remote add origin <你的远程仓库URL>

3. Q：rebase 过程中遇到冲突怎么处理？

如果被删除的提交与后续提交有依赖关系，rebase 时可能出现冲突。解决冲突后执行 git rebase --continue 继续，或者用 git rebase --abort 放弃回到操作前状态。

六、总结

本文针对 Git 仓库中误提交大文件或敏感信息的常见场景，提供了三种清除历史记录的实用方法：

1. 指定提交删除：通过交互式变基（git rebase -i）精确删除某一次或多次提交，保留其他历史记录，适合局部修正。
2. 大文件/敏感文件删除：借助 git-filter-repo 工具，按文件名、目录、通配符或文件大小等条件，从整个历史中彻底移除特定文件，适合清理体积过大或涉密的内容。
3. 全部历史重置：利用孤立分支（--orphan）重建仓库，完全丢弃所有历史提交，适合需要"从头开始"的极端场景。

如何选择？

只需删某几次提交      → 方案一（git rebase -i）
只需删某些文件        → 方案二（git-filter-repo）
整个历史都不要了      → 方案三（git checkout --orphan）

以上操作均会改写 Git 历史，并需要使用 --force 强制推送才能生效，这会对协作开发造成影响。因此，在实际执行前，请务必备份仓库，并与团队成员充分沟通，避免因历史重写导致协作冲突或数据丢失。根据实际问题的严重程度和团队规范，选择最合适的方案，方能安全、高效地完成历史清理工作。