Git仓库删除文件后如何缩小体积并保留提交历史

嘿，我懂你现在的头疼事儿——删了一大堆图片，结果仓库体积半点没变小，这其实是因为Git会把所有历史提交里的文件都死死存着，哪怕你现在把它们从工作区删了也没用。针对你只有一个分支的情况，我给你一套能保留提交历史、彻底瘦身后端仓库的方法：

第一步：彻底抹掉历史里的大文件 #

首先得把那些藏在历史提交里的图片彻底移除，这里推荐用git filter-repo——它比老旧的git filter-branch安全得多，也更高效：

• 先确保你装了git filter-repo：如果是Mac可以用brew install git-filter-repo，Linux用apt install git-filter-repo，Windows的话可以通过Git Bash的包管理器安装。
• 如果你要移除所有图片文件（比如.png、.jpg、.jpeg），就运行这几条命令：

  git filter-repo --path-glob '*.png' --invert-paths
  git filter-repo --path-glob '*.jpg' --invert-paths
  git filter-repo --path-glob '*.jpeg' --invert-paths
  

  要是你知道具体的大文件路径，直接指定路径更精准：

  git filter-repo --path 'assets/images/old-big-photo.png' --invert-paths
  

  这个操作会重写整个提交历史，把所有历史版本里的目标图片彻底删掉，不会留下任何痕迹。

第二步：清理本地仓库的冗余缓存 #

重写历史后，本地仓库会留下一些没用的缓存对象，得把它们清干净：

git reflog expire --expire=now --all
git gc --prune=now --aggressive

第一条命令会清除所有过期的引用记录，第二条会深度清理本地的无用数据，这两步做完，本地仓库体积应该就变小了。

第三步：强制推送到远程仓库 #

因为你重写了提交历史，普通的git push会被远程拒绝，必须用强制推送覆盖远程的历史：

git push origin main --force

（把main换成你实际的分支名，比如master）

重要提醒 #

• 如果你有其他协作开发者，一定要提前跟他们打招呼！远程仓库的历史被重写后，他们本地的仓库会和远程完全不一致，需要让他们先备份本地未提交的修改，然后重新克隆仓库，或者执行git fetch origin后再git reset --hard origin/main（这个操作会覆盖本地所有未提交的内容，千万提醒他们做好备份）。
• 操作前最好先克隆一个仓库的备份，万一操作失误还能找回数据。

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