用git filter-repo轻松清理Git仓库历史的详细教程

Git仓库在长期开发中，往往会积累一些大文件或者误提交的敏感信息。git filter-repo是专业的Git历史重写工具，提供了简单高效的操作接口，帮助我们快速清理和优化仓库历史。本文将带领新手用户了解git filter-repo的安装、基本命令及实战案例。

什么是git filter-repo？

git filter-repo是一个基于Python的Git仓库历史重写工具，替代了传统的git filter-branch，具备更高效的性能和更丰富的功能。它能过滤文件、替换内容、修改提交信息，适合清理大文件和敏感数据。

安装方法

首先，确保已安装Python环境，然后可以通过pip安装：

pip install git-filter-repo

安装完成后，可通过下面命令验证：

git filter-repo --help

基本使用流程

1. 克隆镜像仓库：

git clone --mirror https://github.com/user/repo.git
cd repo.git

2. 运行过滤命令，例如删除大于10MB的文件：

git filter-repo --strip-blobs-bigger-than 10M

3. 过滤指定路径文件：

git filter-repo --path filename.txt --invert-paths

4. 替换敏感信息：

准备替换规则文件replacements.txt，格式为：

password123==>******

执行：

git filter-repo --replace-text replacements.txt

5. 推送清理后的仓库：

git push --force

注意事项

• 重写历史后，所有协作者需重新克隆仓库。
• 运行前务必备份原仓库镜像，防止误操作。
• git filter-repo操作快速，耐心等待命令完成即可。

结语

git filter-repo为Git仓库维护者提供了强大且高效的工具链，特别适合新手用户进行仓库清理和敏感信息移除。掌握该工具，将极大提升Git仓库的管理效率和安全性。