git仓库瘦身清理大文件的方法【实战】
别碰 git filter-branch，它易出错、极慢、留坑；优先用 git-filter-repo（官方推荐、功能全面）或 BFG Repo-Cleaner（Ja va 环境友好、命令直白）。 先说结论：如果你想让Git仓库成功“瘦身”，有件事必须优先明确——远离 git filter-bran
别碰 git filter-branch，它易出错、极慢、留坑；优先用 git-filter-repo（官方推荐、功能全面）或 BFG Repo-Cleaner（Ja va 环境友好、命令直白）。
先说结论：如果你想让Git仓库成功“瘦身”，有件事必须优先明确——远离 git filter-branch。这个老牌工具虽然名气大，但实际用起来坑不少：历史重写容易出错、速度慢得让人心焦，处理完还可能留下各种“后遗症”。相比之下，git-filter-repo 和 BFG Repo-Cleaner 才是更现代、更可靠的选择。前者是官方推荐的新秀，功能全面；后者对Ja va环境更友好，命令也更直白。
怎么快速定位历史里真正占空间的大文件
很多人的第一个误区，是只盯着当前工作区里有没有大文件。其实，Git仓库臃肿的罪魁祸首，往往是那些“已经被删除，却依然活在历史记录里”的大文件。所以，必须从Git对象层进行深度扫描。
- 这条命令能帮你揪出真正的“元凶”：
git rev-list --objects --all | git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | sed -n 's/^blob //p' | sort -n -k 2 | tail -10 | cut -c 1-12,41- | $(command -v gnumfmt || echo numfmt) --field=2 --to=iec-i --suffix=B。它的厉害之处在于，输出的是Blob对象的原始大小（包含路径），而非压缩后的尺寸，结果最为准确。 - 扫描结果出来后，重点关注那些带有
.so、.a、.dll、.zip、.pdf后缀的行。这些文件大概率就是你要找的“僵尸脂肪”。尤其是.so这类编译产物，往往在每次构建时都会生成新的哈希，被多次提交进历史，体积叠加起来非常快。 - 千万别只看
du -sh .git显示的表面数字。这个大小包含了打包文件、引用日志和未清理的悬空对象。更科学的做法是结合git count-objects -vH命令，观察size-pack（打包后大小）和count（对象数量）的比值。如果松散对象的数量远高于打包对象，那就说明仓库里的“垃圾”还没清理干净。
用 git-filter-repo 清理指定大文件或目录
目前来看，git-filter-repo 是最稳妥的清理方案。不过，必须警惕的是，它会重写所有提交的哈希值。这意味着，操作前务必备份整个项目文件夹（注意，不是简单的 git clone）。
- 安装：通过
pip install git-filter-repo安装（需要Python 3.8+），macOS用户也可以直接使用brew install git-filter-repo。 - 重要前提：进入项目根目录后，不要在已经配置了远程origin的仓库里直接运行命令。
git-filter-repo默认会拒绝在非裸仓库上操作。虽然可以加--force参数强制运行，但更推荐的做法是，先用git clone --mirror克隆出一个裸仓库，再对这个裸仓库进行处理。 - 删除单个文件：
git-filter-repo --path path/to/bigfile.so --invert-paths --force。这里的--invert-paths参数是关键，它的作用是“保留除指定路径外的所有内容”，也就是执行剔除操作。 - 删除整个目录：
git-filter-repo --path docs/ --invert-paths --force。这比逐个删除目录下的文件要高效得多。 - 按大小批量删除：
git-filter-repo --strip-blobs-bigger-than 50M --force。这个命令非常适合那些不清楚具体文件路径，但能确定历史中存在大量超大文件的场景。
用 BFG Repo-Cleaner 快速删 >1MB 的 .so 或其他二进制文件
如果你的机器上已经安装了Ja va环境，那么 BFG Repo-Cleaner 会是一个更快捷的选择。它对Windows用户或在CI环境中编写脚本尤其友好。
- 下载：
curl -O https://repo1.ma ven.org/ma ven2/com/madgag/bfg/1.14.0/bfg-1.14.0.jar - 必须使用镜像克隆：先用
git clone --mirror https://your/repo.git克隆仓库，你会得到一个repo.git目录（没有工作区）。 - 删除所有 .so 文件：
ja va -jar bfg-1.14.0.jar --delete-files "*.so" repo.git - 删除所有大于1MB的Blob对象：
ja va -jar bfg-1.14.0.jar --strip-blobs-bigger-than 1M repo.git - 关键后续操作：清理完成后，必须进入
repo.git目录，执行git reflog expire --expire=now --all && git gc --prune=now --aggressive。这一步是释放磁盘空间的核心，如果漏掉，清理效果将大打折扣。
清理完推送到远程前最关键的三件事
很多人在这里栽了跟头：本地清理明明成功了，一推送到远程就报错，或者同事怎么也拉取不下来新代码。问题几乎都出在下面这几个环节：
git-filter-repo会自动删除本地的remote配置。所以，清理后你需要手动加回去：git remote add origin https://your/repo.git。- 强制推送前，先确认远程分支的名称（例如原来是
master）。接着，重命名你的本地分支以匹配（例如git branch -M main）。然后，分别执行git push --force --all origin和git push --force --tags origin来推送所有分支和标签。 - 所有协作者必须重新克隆仓库，而不能使用
git pull。因为历史已经被重写，旧的提交哈希全部失效了。记得提醒他们，在git clone新仓库后，运行git log --oneline | head -5检查前几条提交的哈希值是否与你推送的一致。 - 如果项目使用了 Git LFS，清理后记得重新执行
git lfs track来指定跟踪规则，并git add .gitattributes。否则，LFS规则不会在新的历史记录中生效。
最后，还有一个最容易被忽略的点：清理工具只修改了提交历史，并不会自动删除你本地工作区中残留的那些大文件。在执行完所有步骤后，务必手动检查并 rm -rfbuild/、dist/、.so 等文件。更重要的是，立刻把它们添加到 .gitignore 文件中。否则，下一次提交时，它们很可能又会悄无声息地溜回仓库，让之前的清理工作前功尽弃。
WPS Office是一款面向macOS用户的综合办公套件，将文字处理、电子表格、演示文稿、PDF工具、模板与云协作整合在同一应用中。它兼容常见Microsoft Office格式，支持Intel及Apple芯片Mac，基础功能可免费使用，
Shapr3D是一款面向工业设计、机械工程、建筑概念和三维打印工作流的CAD软件。Mac版采用Parasolid建模内核，支持草图约束、实体建模、工程图、可视化渲染及常见CAD格式交换，并可通过账户在多台设备之间同步项目。
REAPER是Cockos开发的数字音频工作站，提供多轨音频与MIDI录制、剪辑、处理、混音和母带制作工具。Mac版兼容Intel与Apple芯片，支持AU、VST、VST3、CLAP等插件格式，并提供高度可定制的工作流程。
Ableton Live 是面向音乐制作人与现场表演者的数字音频工作站，提供编曲视图、独具特色的现场视图、音频录制、MIDI创作、实时变速、乐器及效果器。Mac版原生支持Apple芯片，并可连接音频接口、MIDI控制器和第三方插件。
Adobe After Effects 是面向动态图形、影视特效与视频合成的专业创作软件。它提供关键帧动画、遮罩抠像、运动跟踪、三维空间、文字动画和表达式等工具，并可与 Premiere Pro、Photoshop、Illustrator
Adobe Audition 是面向播客、影视后期、音乐制作及内容创作者的专业音频工作站，提供波形精修、多轨录制与混音、频谱编辑、降噪修复、响度匹配和效果处理工具，并可与 Adobe Premiere 协同完成视频声音制作。
Adobe Bridge 是面向摄影师、设计师及内容团队的免费数字资产管理工具，可集中预览照片、视频和 Adobe 项目文件，并利用评级、标签、关键词、元数据、筛选与收藏集完成分类检索。它还支持批量重命名、格式导出、相机导入及 Camera
Adobe Illustrator 是 Adobe 推出的专业矢量图形设计软件，适合在 Mac 上制作标志、图标、插画、包装、信息图及印刷版面。它以路径和锚点构建可无损缩放的图形，并提供钢笔、形状、文字、图像描摹、渐变、画板及生成式功能。
Adobe InDesign 是面向印刷品与数字出版物的专业版面设计软件，可在 Mac 上制作书籍、杂志、宣传册、海报、报告及交互式文档。它提供精细的文字样式、网格、母版、长文档管理和印前输出能力。
Adobe Lightroom Classic 是面向桌面摄影工作流的照片管理与后期处理软件，可将原始照片保存在本地硬盘，通过目录、关键词、评分和收藏夹高效整理图库，并提供 RAW 冲印、蒙版、镜头校正、批量同步及多格式导出等功能。
Adobe Media Encoder 是 Adobe 推出的专业音视频编码与转码工具，可通过队列、预设和监视文件夹批量完成格式转换、代理文件创建及多平台成片输出，并与 Premiere Pro、After Effects 等软件紧密协作。
Adobe Photoshop 是面向摄影师、设计师和内容创作者的专业图像处理软件，提供图层、蒙版、选区、修复、调色、文字排版、智能对象及生成式编辑等能力。Mac 版支持 Intel 与 Apple Silicon 处理器。
BricsCAD 是以 DWG 为核心格式的专业 CAD 平台，可用于二维制图、三维建模、工程文档与设计协作。产品按 Lite、Pro、BIM、Mechanical 和 Ultimate 等层级提供不同工具，
Ableton Live 是面向音乐创作、录音、编曲、声音设计、混音与现场演出的数字音频工作站。它将适合即兴触发素材的 Session 视图与传统时间线编曲结合，并提供音频变速、MIDI工具、软件乐器、效果器和声音资源，
FL Studio 是 Image-Line 推出的数字音频工作站，面向音乐制作人、编曲者、歌手及声音设计人员。它将步进音序、钢琴卷帘、音频录制、剪辑、混音、自动化和插件宿主整合在统一环境中，并提供大量乐器、效果器、采样与预设。
Pro Tools 是 Avid 推出的专业数字音频工作站，提供多轨录音、音频剪辑、MIDI编曲、插件处理、自动化混音及影视声音制作能力。它适合音乐人、录音师、制作人和音频后期团队使用，并提供免费入门版、订阅方案及永久授权选择。
Adobe Audition 是面向播客、影视后期、广播与音乐制作的专业音频工作站，提供波形编辑、多轨混音、频谱分析、录音、降噪修复和效果处理等功能。Windows 版通过 Adobe Creative Cloud 安装和管理，
REAPER 是 Cockos 推出的数字音频工作站，适用于录音、MIDI 编曲、音频编辑、混音、母带制作及声音设计。软件安装包小巧，支持多轨录制、灵活路由、自动化、第三方插件和脚本扩展，并提供完整功能的 60 天免费评估期。
Visual Studio Code 是微软推出的免费代码编辑器，Windows 版集成智能补全、代码导航、调试、终端和版本控制，并可通过扩展添加语言、格式化及远程开发能力。它启动较快、配置灵活，
Cubase 是 Steinberg 推出的数字音频工作站，提供 MIDI 编曲、多轨录音、音频编辑、虚拟乐器、效果处理、自动化、混音和母带输出工具。其 Pro、Artist 与 Elements 版本面向不同预算和制作规模，
JetBrains IntelliJ IDEA 是以 Java、Kotlin 和 JVM 项目为核心的专业集成开发环境，提供智能补全、代码检查、安全重构、调试、测试、版本控制及构建工具集成。统一发行版的核心功能可免费用于商业和非商业项目，
Android Studio 是 Google 面向 Android 应用开发提供的官方集成开发环境，以 IntelliJ IDEA 为基础，集成智能代码编辑、Gradle 构建、设备模拟、界面预览、调试测试及性能分析工具，
Docker Desktop 为 Windows 开发者提供集成式容器环境，内置 Docker Engine、命令行工具、Compose、Build 与 Kubernetes 等组件，可在本机完成镜像构建、容器运行、日志查看和资源管理。
Postman 是面向 API 全生命周期的开发与协作平台。Windows 桌面版可用于构建和发送 HTTP、GraphQL、gRPC、WebSocket、MQTT 等请求，并提供环境变量、集合、脚本测试、模拟服务、监控、文档及团队工作区等