先执行git gc --prune=now --aggressive和git repack快速释放20%–50%空间，再用git rev-list定位历史大文件，接着用bfg彻底剥离，最后通过git lfs配置防复发。
直接上手清理，别被“数十GB”吓住。Git 仓库膨胀到这种程度，核心问题不是空间本身，而是大量历史大文件 + 未回收的松散对象 + 残留引用长期堆积。处理的关键是分两步走：先快速释放可观空间（不改历史），再针对性切除病灶（重写历史）。下面按实际操作顺序说明。
第一步：紧急止血——用 git gc 和 repack 清理临时垃圾
这是最安全、最快见效的操作，不触碰任何提交历史，只回收已失效但尚未删除的对象。
- 进入仓库根目录，运行：git gc --prune=now --aggressive。这个命令会打包松散对象、删除过期 reflog 条目、压缩重复数据。对几十GB仓库，可能耗时数分钟，但通常能立即释放 20%–50% 空间。
- 补一刀更彻底的压缩：git repack -a -d -f --depth=250 --window=250。它强制重新打包所有对象，启用深度 delta 压缩，特别适合含大量相似二进制文件（如图片、模型）的仓库。
- 清理完后执行：git count-objects -vH，对比 size-pack 和 size 数值。如果 size（松散对象）从 GB 级降到 KB 级，说明这一步已起效。
第二步：精准定位——找出真正占空间的历史“元凶”
光靠 gc 不够，因为误提交的大文件（比如 100MB 的 PSD、500MB 的数据库 dump）哪怕已被 rm 删除，其完整 blob 仍躺在历史里。必须挖出来。
GitHub Smart Code Digest
下载
GitHub Smart Code Digest — 自动监控仓库 Commits/PR，AI 智能代码审查，生成可视化审查卡片并汇总至飞书 Wiki。适用于团队代码质量追踪和工程管理者日报/周报生成。触发词：代码审查报告、GitHub 监控、PR 审查日报、代码质量汇总、工程师日报。
- 快速扫描全历史最大 20 个 blob：
git rev-list --objects --all | git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | awk '/^blob/ {print $3, $4}' | sort -n | tail -20 - 把输出结果中体积超 5MB 的哈希值提取出来，反查路径：
git show --name-only^! 2>/dev/null | head -1 （逐个查）或批量用：
git rev-list --objects --all | grep "$(echo 'hash1 hash2' | tr ' ' '\n')" | cut -d' ' -f2- - 重点关注：.zip/.rar/.7z、.psd/.ai/.sketch、.mp4/.mov、.unitypackage、build/、dist/、node_modules/（若曾误提交）、logs/ 等路径。
第三步：外科手术——用 BFG Repo-Cleaner 彻底剥离历史大文件
BFG 比 git filter-repo 更快、更简单，专为这类场景设计，且默认保留所有分支和标签结构。
- 下载 jar 包：curl -o bfg.jar https://repo1.maven.org/maven2/com/madgag/bfg/1.14.0/bfg-1.14.0.jar
- 创建裸克隆（关键！避免污染工作区）：git clone --mirror
repo-mirror.git - 运行清理（示例）：
java -jar bfg.jar --strip-blobs-bigger-than 5M repo-mirror.git
或精准删除特定文件：
java -jar bfg.jar --delete-files 'config-prod.json' --delete-folders '__pycache__' repo-mirror.git - 执行 GC 并推回：
cd repo-mirror.git && git reflog expire --expire=now --all && git gc --prune=now --aggressive && git push --force --all && git push --force --tags
第四步：防复发——建立长期防护机制
瘦身后不设防，几个月就打回原形。两个硬性动作必须落地：
-
全局 Git 配置禁止大文件：在 ~/.gitconfig 加入
[core]
autocrlf = true
[filter "lfs"]
required = true
clean = git-lfs clean -- %f
smudge = git-lfs smudge -- %f
process = git-lfs filter-process -
项目级 .gitattributes 强制 LFS：在仓库根目录添加该文件，写明哪些后缀走 LFS：
*.psd filter=lfs diff=lfs merge=lfs -text
*.fbx filter=lfs diff=lfs merge=lfs -text
*.unitypackage filter=lfs diff=lfs merge=lfs -text
