如何清理误提交到git的历史大文件？

摘要：不过看到我之前开发的视频剪辑工具 Clipify[1]收获了不少 star ，让我想起之前画的饼似乎才实现了一点点，所以利用了周末的空闲时间给 Clipify 项目重构了一下界面以及开发一些新功能。

哈喽！好久不见~

最近在思考转型的事情，好久没有更新文章了

不过看到我之前开发的视频剪辑工具 Clipify[1]收获了不少 star ，让我想起之前画的饼似乎才实现了一点点，所以利用了周末的空闲时间给 Clipify 项目重构了一下界面以及开发一些新功能。

预告一下，这是重构之后的新界面，后面我会写一篇文章介绍一下。

中途意识到现在使用的 WinForms + Blazor 技术栈，就像马拉火车，有种蒸汽朋克的复古感，虽然使用前端技术开发的界面很好看，但 WinForms 不能跨平台终究不是长久之计。

于是我便着手尝试迁移到 MAUI，虽然还不能支持 Linux，至少 Mac 还是可以的，也算是跨平台了吧…

然而我还没把项目跑起来呢，一不小心把一堆静态资源给提交进去了

就是下面这些文件

Clipify.Maui/wwwroot/lib/
Clipify.Maui/wwwroot/css/*.min.css
Clipify.Maui/wwwroot/temp/
这下Git push超级慢，而且会占用大量空间

还好最终在大模型爷爷的帮助下解决了这个问题

不过我想总不能老是去打扰大模型爷爷啊，问题解决了还是得记录一下，以后遇到类似的情况也好处理。

这个问题其实老生常谈了

网上能查到的很多文章都会告诉你可以用以下命令解决

git rm -r --cached Clipify.Maui/wwwroot/lib
git rm --cached Clipify.Maui/wwwroot/css/*.min.css
git rm -r --cached Clipify.Maui/wwwroot/temp

这些命令会移除已提交的文件，但不会删除本地文件

但我这样做了之后还是不行，git push 的时候还是很慢

它解决的是「现在开始不要再跟踪」的问题，但历史上它已经跟踪过的文件，Git 还会一直保留在对象数据库（.git/objects）里

我在前面几个 commit 已经把 Clipify.Maui/wwwroot/lib 这类文件夹提交进去了

所以这个命令对于这个场景来说是没用的😂

简单来说，Git 是个版本管理工具，它不会忘记你历史上做过的提交，哪怕现在git rm --cached移除了lib/Git 仍然记得之前在第 N 次 commit 时曾经加入过它，所以.git目录依然保存了那些大 blob 文件，push时照样要传。

那么如何解决呢？

以前看到的方法是编写脚本，循环从每个 commit 里删除已提交的文件

现在不用这么麻烦了，有了 git-filter-repo 工具，这是一个 python 写的可以用来重写 git 历史记录的工具

感谢 scoop ，让我在 Windows 上也能获得类似 Linux/MacOS 类似的软件安装体验

# 安装 Git Filter Repo
brew install git-filter-repo# macOS
scoop install git-filter-repo# Windows
# 或者用 Python 安装
pip install git-filter-repo

使用方法

git filter-repo --path Clipify.Maui/wwwroot/lib/ --invert-paths --force

这个命令会彻底删除历史中所有与该路径相关的文件和提交记录

重写整个 Git 提交历史之后，仓库大小会明显减小，git push更快，历史提交中指定文件将完全移除。可能需要使用--force强制推送代码。

经过这一通操作之后，我再使用 git push 提交明显快了很多。

用 [+git verify-pack] 可以找出 Git 提交历史中的大对象（大文件）

不过 git 原生的命令比较复杂

我还是选择借助工具的力量，这次是 git-sizer 工具

git-sizer[2]是 GitHub 官方出的工具，用于分析 Git 仓库大小、提交体积等问题。

brew install git-sizer
# or
scoop install git-sizer
# or
cargo install git-sizer

PS：再次感谢 scoop ！

直接在项目根目录下执行git-sizer即可

这个工具会输出以下信息：

最大的提交

最大的 blob（文件内容）

最大的目录

含大文件的分支

是否存在历史中隐藏的肥胖对象（hidden bloats）

我使用这个工具生成的结果是这样

Processing blobs: 2448
Processing trees: 218
Processing commits: 42
Matching commits to trees: 42
Processing annotated tags: 0
Processing references: 3
| Name | Value | Level of concern |
| | --------- | |
| Biggest objects | | |
| * Trees | | |
| * Maximum entries [1] | 1.40 k | * |

[1] 77b7ff2aa0456193bee83eebe9dfb76ebd4f35ac (2d9cc135f1aff0863ce2ef8ceff3cbf6984ee499:Clipify.Maui/wwwroot/lib/font-awesome/svgs/solid)

这样就能很方便定位到最大的文件，给 git 仓库瘦身~

[1]

Clipify:

[2]

git-sizer:

🔹《DeepSeek极速上手手册》24页干货：零基础3天玩转智能编码

🔸清华独家课程三部曲：

❶《DeepSeek从入门到精通》104页精讲（附30+代码实例）

❷《职场效能革命指南》35页实战：7大行业应用场景深度拆解

❸《AI红利捕获手册》65页秘籍：普通人快速构建竞争壁垒的5种路径

与万千技术人共建智能开发新范式。