在日常开发中，Git 仓库常会因误提交图片、二进制库、资源文件等变得臃肿，导致克隆、拉取速度缓慢。本文结合实际场景，分享一套完整的仓库瘦身方案，涵盖大文件排查、历史清理、远程同步及长期防护，帮助将臃肿仓库恢复轻量化状态。

一、仓库臃肿原因分析

Git 仓库体积过大，核心原因通常包括：

1. 提交了图片、GIF、字体文件、动态库（.so/.dll）等二进制资源，这类文件压缩效率低，且会保留完整历史版本；
2. 冗余目录未及时清理，包含大量非代码文件（配置、日志、缓存等）；
3. 已删除的大文件仍残留于 Git 历史中，未彻底移除。

通过 du -sh .git 命令可快速查看版本库体积，若超过 10MB 且无特殊需求，通常需要进行瘦身优化。

二、核心工具与前置准备

1. 关键工具

• Git 原生命令：用于排查文件、清理冗余对象；
• BFG Repo-Cleaner：高效删除 Git 历史中的指定文件 / 目录，比原生 git filter-branch 更快更简洁（需 Java 运行环境）。

2. 工具安装（Linux/Mac）

3. 重要前置操作

瘦身前务必备份仓库，避免误操作导致数据丢失：

三、仓库瘦身完整步骤

1. 排查大文件与冗余目录

首先定位仓库中占用空间较大的文件及目录，明确清理目标：

通过该命令可筛选出历史中残留的大文件及所在目录，作为后续清理的重点目标。

2. 批量清理目标文件 / 目录

根据排查结果，分场景进行精准清理，优先删除整个冗余目录（效率更高）。

场景 1：删除整个冗余目录（推荐）

若某目录下无重要代码（如全是资源文件、废弃模块），直接删除整个目录及历史记录：

场景 2：删除指定类型大文件

若需保留目录仅删除特定类型文件（如图片、字体、二进制库），按文件类型批量删除：

3. 彻底清理 Git 残留对象

删除历史文件后，Git 会保留无用对象，需执行垃圾回收彻底清理：

4. 验证清理效果

清理后需确认大文件已彻底移除，仓库体积符合预期：

正常情况下，仓库体积会从几十 MB 降至 1-2 MB（纯代码仓库水平）。

5. 远程仓库同步

本地清理完成后，需强制推送更新到远程仓库，替换远程的臃肿历史（仅仓库独占或已通知协作成员时操作）：

四、长期防护：避免仓库再次臃肿

1. 完善 .gitignore 配置

在仓库根目录的 .gitignore 文件中添加规则，禁止跟踪非代码文件：

2. 制定提交规范

• 禁止直接提交大于 5MB 的文件；
• 资源文件（图片、视频等）通过 CDN 或对象存储服务托管，不纳入 Git 版本控制；
• 定期（3-6 个月）执行 git gc --aggressive，优化仓库体积。

五、常见问题排查

1. 推送失败（stale info 报错）

原因：本地跟踪的远程信息过期，解决方式：

2. 清理后仓库体积反弹

原因：远程仍保留臃肿历史，拉取时重新同步，解决方式：

• 先强制推送本地干净历史到远程；
• 后续拉取前先查看远程提交记录，确认无冗余历史后再操作。

3. BFG 执行报错（路径相关）

原因：--delete-files 参数仅支持文件名，不支持完整路径，解决方式：

• 按文件名批量删除，或用 --delete-folders 按目录删除；
• 示例：java -jar bfg-1.14.0.jar --delete-files "目标文件名" 仓库目录。

六、总结

Git 仓库瘦身的核心是「彻底清理历史大文件 + 禁止后续误提交」，通过 BFG 工具可高效移除冗余内容，配合 Git 垃圾回收和远程强制推送，能快速将臃肿仓库恢复轻量化状态。后续通过规范提交行为和完善 .gitignore 配置，可长期保持仓库精简，提升开发协作效率。