如何减小.git/objects目录体积？Git仓库历史清理相关咨询

针对.git目录因历史提交残留大文件膨胀的问题，你提到的三类清理需求均可通过Git原生命令实现，无需额外安装工具，具体方案如下：

1. 从全量提交历史中彻底清除指定目录 #

可以实现，操作会遍历所有分支、标签的全部提交记录，将目标目录从每一个提交快照中永久移除。
执行命令：

git filter-branch --force --index-filter 'git rm -rf --cached --ignore-unmatch 目标目录路径/' --prune-empty --tag-name-filter cat -- --all

命令执行完成后，清理冗余的历史残留对象，缩小.git实际体积：

rm -rf .git/refs/original/
git reflog expire --expire=now --all
git gc --prune=now --aggressive

你已确认待删除目录无依赖项，不会出现代码关联断裂问题，可直接执行该操作。

2. 移除特定提交之前的所有历史 #

可以实现，操作后指定的分界提交会成为仓库新的根提交，之前的所有提交链、关联文件都会被彻底清除。
操作步骤：

• 先通过git log找到你要保留的最早提交的完整哈希值（即分界点，该提交之前的所有历史都会被删除）
• 执行嫁接命令将该提交设为根提交：
  git replace --graft <分界提交完整哈希值>
• 让修改永久生效到所有分支：
  git filter-branch -- --all
• 执行上文中提到的reflog清理、gc命令释放空间即可。

你提到的全量历史留存需求，只需在操作前将未修改的原始仓库完整拷贝到不关联远程的独立目录存储即可，无需额外操作。

3. 仅保留最近一次提交，清除其余所有历史 #

这是截断历史场景的最简特例，操作比普通截断更简单，无需查找提交哈希：

# 创建一个没有任何历史的孤立分支
git checkout --orphan latest_branch
# 把当前工作区所有文件加入暂存区
git add -A
# 提交当前状态作为新的初始提交
git commit -m "初始化（截断历史后版本）"
# 删除旧的主分支（如果你的主分支是main，把下面的master换成main即可）
git branch -D master
# 把当前孤立分支重命名为主分支
git branch -m master

执行完成后，同样运行reflog清理、gc命令，.git目录体积会直接降到和当前工作区文件大小匹配的水平。

清理后对其他协作者的影响 #

历史清理属于重写仓库提交链的破坏性操作，对协作者的影响及应对要求如下：

• 如果协作者直接在旧本地仓库上执行git fetch/git pull/git merge，会把本地残留的旧历史重新合并进远程仓库，直接导致清理失效
• 正确的协作流程：清理完成强制推送到远程后，通知所有协作者不要直接拉取合并，先把本地未提交的改动备份导出，删除本地旧仓库，重新从远程地址克隆清理后的全新仓库，再把备份的未提交改动拷贝到新仓库继续开发
• 如果协作者本地有尚未推送到远程的功能分支，需要先把分支改动导出为patch文件，在新克隆的干净仓库上重新应用patch，不能直接合并旧的本地分支。

通用注意事项 #

• 所有历史重写操作不可逆，执行任何清理步骤前，请先给整个仓库做全量备份，避免操作失误丢失代码
• 本地清理完成、确认.git体积符合预期后，需要执行强制推送把修改同步到远程：

  git push origin --force --all
  git push origin --force --tags
  

• 部分自建Git托管平台需要在后台手动触发仓库垃圾回收，才会彻底释放远程服务器上的存储空间。

内容的提问来源于stack exchange，提问作者Walt Howard