删除 Git 中的历史记录
在 Git 版本控制中，删除历史记录（通常指清除提交历史中的敏感信息、冗余内容或重构历史）并非常规操作，而是针对特定场景的 “补救” 或 “优化” 手段。因为Git 历史记录本质是 “提交快照的链式存储”，一旦提交被推送到公共仓库，历史会被团队共享。
一、为什么要删除历史记录？常见场景
1、历史中包含敏感信息（泄密）
这是删除历史最核心的场景 —— 若误将账号密码、密钥、API 密钥、个人隐私数据（身份证 / 手机号）、商业机密（合同 / 架构图） 等提交到 Git 仓库（尤其是公共仓库如 GitHub/GitLab），即使后续提交删除了这些文件，它们仍会保存在历史快照中，任何人都可通过git log+git checkout回溯获取，存在严重安全风险。
2、历史记录冗余 / 混乱（影响协作效率）
长期开发中，若存在大量 “临时调试”“修复拼写错误”“合并冲突残留” 等无意义的零散提交，会导致历史记录冗长、逻辑混乱 —— 新成员查看git log时难以追踪核心功能的开发脉络，排查问题时也需在大量冗余提交中筛选，降低协作效率。
例如：
个人开发时频繁提交 “临时保存” 类代码，导致单功能对应 10 + 无意义提交
多人协作时，合并分支产生大量 “Merge branch 'xxx' into 'main'” 提交，掩盖核心开发逻辑
3、历史文件过大，导致仓库体积膨胀
Git 仓库会保存所有历史版本的文件快照，若历史中提交过大文件（如超过 100MB 的安装包、视频、压缩包），即使后续删除该文件，其历史快照仍会占据仓库存储空间。此时需删除包含大文件的历史提交，并用git gc（垃圾回收）压缩仓库体积
4. 合规性要求（企业 / 行业规范）
部分行业（如金融、医疗）或企业有严格的数据合规要求，规定 “敏感数据不得留存于任何可追溯的记录中”。
二、如何删除历史记录？
2.1、操作前必须备份仓库
删除历史是不可逆操作（除非有备份），建议先通过git clone --mirror创建仓库镜像备份，或复制本地仓库目录，避免数据丢失。
2.2、常用工具
轻量改写（如删除最近 N 个提交）：用
git reset --hard HEAD~N；彻底清除敏感文件 / 大文件：需用专门工具如
BFG Repo-Cleaner或git filter-repo（Git 官方推荐，比git filter-branch更高效）；重构历史：用
git rebase -i <commit-id>（交互式变基），可删除、合并指定提交。
2.3、具体步骤
2.3.1、使用Git Reset方式
1、使用 git log 命令查看历史记录
git log --oneline
这会列出当前分支上的所有提交记录，每个记录都有一个 SHA-1 标识符（第一列）和一个消息（后面的列）
2、使用 git reset 命令将当前分支重置到要删除的提交之前
例如，如果要删除最近的三个提交记录，则可以使用：
git reset HEAD~3
这样就将当前分支重置到了前三个提交记录之处，历史记录中的最后三个提交会被删除
3、使用 git push -f 命令强制推送到远程仓库，覆盖历史记录
git push -f
这会使其他人在拉取更新时遇到问题，因此需要确保所有有权限的人知道此操作。
注意：
使用git push --force（或git push --force-with-lease，更安全，避免覆盖他人提交）强制推送，但这会覆盖远程历史，仅限个人仓库或获得团队一致同意的场景。
2.3.2、使用 BFG Repo-Cleaner
BFG Repo-Cleaner是一个 Java 程序，可以在本地运行，删除 Git 仓库中的历史记录。
首先，安装 BFG Repo-Cleaner，例如可以使用 Homebrew 在 Mac 上安装，也可以从官网下载并安装到计算机上。
brew install bfg
示例;
$ java -jar /path/to/bfg.jar --delete-files filename.txt.git $ git reflog expire --expire=now --all && git gc --prune=now --aggressive $ git push
其中，filename.txt.git 是包含要删除内容的文件名（例如 .git-credentials）。这里使用 BFG Repo-Cleaner 删除提交历史、refs 和 tags，然后重新压缩存储库。
注：BFG Repo-Cleaner 可以删除仓库中的任何内容，因此需要小心操作。
2.3.3、创建一个新的 Git 仓库，只包含要保留的提交记录