寻求自动识别并清理Git历史中相互抵消提交的工具

可行工具与实操方法 #

1. git filter-repo（官方推荐工具） #

这是Git官方主推的历史清理工具，替代了老旧的git filter-branch，稳定性和效率更高。

• 先安装工具：通过包管理器（如apt install git-filter-repo或brew install git-filter-repo）完成安装
• 先做历史分析：运行以下命令生成仓库变更统计报告，帮你定位添加后又被移除的代码块：

  git filter-repo --analyze
  

• 查看分析结果：在生成的filter-repo/analysis/目录下，added-removed.txt文件会列出所有添加后又被删除的内容，可据此确定清理目标。
• 精准清理：可以用--path参数指定要处理的文件，或者编写自定义Python脚本（git filter-repo支持脚本扩展），自动移除那些相互抵消的变更。

2. 交互式变基（git rebase -i）半手动清理 #

如果仓库历史不算特别复杂，交互式变基配合人工判断更精准：

• 定位到包含目标WIP更改的最早提交，执行：

  git rebase -i <目标起始提交哈希>~1
  

• 在弹出的编辑界面中，将需要检查的提交标记为edit，逐个进入提交修改流程：用git reset HEAD^撤销当前提交，手动保留有效代码，丢弃被后续提交抵消的WIP内容，再用git commit --amend更新提交，最后执行git rebase --continue推进变基。

3. 合并废弃提交序列 #

如果某段连续的WIP提交最终完全被废弃，可直接合并后删除：

• 在交互式变基中，将这些WIP提交全部标记为squash，合并后清空提交信息生成空提交，完成变基后用git filter-repo移除所有空提交即可。

关键注意事项 #

• 操作前必须备份仓库，修改Git历史不可逆，失误可能导致数据丢失。
• 若为公共协作仓库，修改历史后需强制推送（git push --force），务必提前和所有协作开发者沟通。
• 复杂历史场景下，可能需要编写自定义脚本分析变更依赖，避免误删有效代码。

内容的提问来源于stack exchange，提问作者Hendrik Wiese