如何优化git仓库体积

优化 Git 仓库体积通常可以从清理历史大文件、压缩对象、规范提交与忽略规则、使用浅克隆/部分克隆等方面入手。下面按「由重到轻」的方式给你一套实用方案。

一、先评估仓库体积来源（很重要）

git count-objects -vH
du -sh .git

更详细地看大文件：

git rev-list --objects --all \
 | git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' \
 | awk '/^blob/ {print $3, $4}' \
 | sort -n

二、清理历史中的大文件（最有效）

1. 使用 git filter-repo（推荐）

官方已取代 filter-branch

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

或删除某个文件的所有历史：

git filter-repo --path path/to/bigfile --invert-paths

⚠️ 注意：

• 会重写提交历史
• 需要通知所有协作者重新 clone

2. 使用 BFG Repo Cleaner（简单高效）

java -jar bfg.jar --strip-blobs-bigger-than 10M repo.git

三、清理本地与远程冗余对象

git gc --aggressive --prune=now
git repack -ad

清理远程：

git remote prune origin

四、合理使用 .gitignore 与 Git LFS

1. 避免误提交

*.log
node_modules/
build/
*.zip

2. 大文件使用 Git LFS

git lfs install
git lfs track "*.psd"
git add .gitattributes

五、减少 clone 体积（协作优化）

浅克隆

git clone --depth 1 repo.git

部分克隆（Git 2.19+）

git clone --filter=blob:none repo.git

稀疏检出

git sparse-checkout init --cone
git sparse-checkout set src docs

六、长期维护建议

• 不在仓库里放构建产物
• CI 产物放对象存储
• 定期 git gc
• 大项目用 monorepo + 子模块 / 多仓

如果你愿意，可以告诉我：

• 仓库语言 / 类型（前端 / 游戏 / ML）
• 当前体积（如 2GB）
• 是否是团队仓库

我可以给你针对性的最小化操作方案。