介绍如何使用 git-filter-repo 工具清理 Git 历史记录以减小仓库体积。针对.git 文件夹过大、误提交敏感文件或媒体文件等问题，该工具比 git filter-branch 更高效安全。文章涵盖安装方法（pip/brew）、常见场景操作（批量删除后缀、移除敏感目录、提取子目录）以及清理后的远程同步步骤。强调重写历史会改变 Commit Hash，需强制推送并通知团队成员重新克隆或重置分支。建议配合.gitignore 和 Git LFS 预防此类问题。
在日常开发中，你是否遇到过这样的情况：项目代码本身没多少，但执行 git clone 时却要下载几个 G 的数据？或者偶尔手抖，把包含密码的配置文件、测试用的 .mp4 视频、甚至是庞大的 .node_modules 目录提交到了 Git 中。
即便你随后立刻执行了 git rm 删除了这些文件，并在最新的 commit 中修复了问题，Git 的核心机制依然会忠实地在历史树中永久保留它们。这些'历史遗留物'会持续占用磁盘空间，拖慢拉取代码的速度。
为了彻底将它们从历史记录中抹除，我们需要重写 Git 历史。
过去，我们常使用 git filter-branch 或 BFG Repo-Cleaner。推荐使用 Git 官方推荐的替代工具：git-filter-repo。它不仅速度极快，而且功能强大、语法简洁。
git-filter-repo 是一个用于重写 Git 历史记录的通用工具。根据 Git 官方文档的建议，由于 git filter-branch 存在性能和安全性问题，git-filter-repo 已经成为了执行此类任务的首选标准。
安装过程非常简单。由于它是基于 Python 编写的，最推荐的安装方式是使用 pip：
# 确保你的系统中已安装 Python 3
pip install git-filter-repo
如果你是 macOS 用户，也可以直接使用 Homebrew：
brew install git-filter-repo
⚠️ 终极警告： 重写历史会改变所有受影响 commit 的 Hash 值。在进行以下任何操作前，请务必备份你的项目，或者在一个全新的 clone 目录中进行测试！
这也是我在实际开发中最常遇到的情况。假设我们需要把项目中所有历史提交里的图片和视频彻底清理掉，只需在项目根目录执行：
git filter-repo --path-glob '*.png' --path-glob '*.mp4' --invert-paths --force
参数解析：
--path-glob: 用于指定匹配模式。--invert-paths: 这是一个非常巧妙的参数，它告诉工具：保留除了匹配路径之外的所有文件。换句话说，就是删除匹配到的文件。--force: 如果你不是在一个 fresh clone（全新克隆）的裸仓库（bare repo）中操作，工具会出于安全考虑阻止你，加上此参数可强制执行。如果有人不小心把 config/database.yml（包含线上数据库密码）提交了，你可以这样抹除它：
git filter-repo --path config/database.yml --invert-paths --force
删除整个文件夹（比如不小心提交的 dist 编译产物）：
git filter-repo --path dist/ --invert-paths --force
有时候我们需要把一个巨型单体仓库中的某个模块（如 src/utils/）单独拆分出来。这个工具也能轻松搞定：
# 这会保留 src/utils 下的内容，并将其提升为仓库的根目录，丢弃其他所有文件
git filter-repo --subdirectory-filter src/utils/
由于 git-filter-repo 是具有破坏性的，为了防止意外的误操作覆盖远程分支，工具在执行完毕后会自动移除你的 remote（远程源）配置。
因此，当你确认本地仓库清理无误，且 .git 文件夹体积显著减小后，需要重新关联并推送到远程：
# 1. 重新添加远程仓库地址
git remote add origin <你的远程仓库 URL>
# 2. 强制推送所有分支到远程服务器
git push origin --force --all
# 3. 如果你有标签（Tags），也需要强制推送标签
git push origin --force --tags
团队协作注意事项：
由于你重写了公共历史，团队中的其他成员不能再使用简单的 git pull。他们需要重新 clone 仓库，或者使用 git fetch origin && git reset --hard origin/main（假设主分支是 main）来强制同步你清理后的最新历史。
使用 git-filter-repo 可以极其高效地给 .git 目录'减肥'。日常开发中，我们还是应该养成良好的习惯，提前配置好 .gitignore 文件。对于确实需要版本控制的大型二进制文件，建议尽早引入 Git LFS (Large File Storage) 进行管理。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online