Git Filer Repo快速指南

本文使用claude code编写，旨在提供一个详尽的 git-filter-repo 使用指南，涵盖安装、基础概念、路径和内容过滤、实用场景、高级功能、安全机制、完整工作流示例、故障排除、性能优化、常见错误与陷阱、与其他工具配合以及最佳实践总结等方面的内容。

什么是 git-filter-repo?

git-filter-repo 是一个快速、功能强大的 Git 历史重写工具,是 git filter-branch 的官方推荐替代品。它由 Git 项目贡献者 Elijah Newren 开发,速度比 filter-branch 快 10-100 倍以上。

核心原理:

git fast-export  | filter | git fast-import 

git-filter-repo 同时扮演管道编排者和中间过滤器的角色,基于 fast-export 和 fast-import 实现高效的历史重写。

为什么选择 git-filter-repo?

vs git filter-branch

Git 官方警告: filter-branch 的问题无法向后兼容地修复,强烈建议停止使用。