使用Git LFS缩减仓库大小遇异常，寻求解决方案

一、Git LFS完全可行 #

Git LFS就是为解决大文件导致Git仓库臃肿的问题设计的，操作正确的话，能把大文件迁移到专门的LFS存储，本地仓库只保留几KB的指针文件，长期来看可大幅缩减仓库体积。你的问题完全是操作步骤错误导致的。

二、你的操作步骤中的错误 #

• 顺序颠倒，先提交大文件到Git仓库：克隆仓库后你先手动执行git add <file>并提交推送，这会把.iso大文件直接存在Git的对象库中（而非LFS）。之后执行git lfs migrate import虽会重写历史把旧提交里的大文件换成LFS指针，但原来的大文件对象仍留在本地和远程仓库的历史记录里，相当于仓库同时存储了旧大文件和新LFS指针，体积自然翻倍。
• migrate后多余的add和commit操作：git lfs migrate import本身会自动重写Git历史并生成新提交，不需要再手动执行git add .和commit，这一步额外操作只会增加仓库冗余内容。
• 未清理冗余对象：即使migrate完成，本地和远程仓库里原有的大文件对象仍未被删除，这些冗余数据依然占用空间，导致仓库体积未下降。

三、正确的操作流程 #

1. 初始化LFS并克隆仓库：

   git lfs install
   git clone <repository-url>
   cd <你的仓库名>
   

2. 用migrate重写历史，迁移所有历史中的.iso文件：

   git lfs migrate import --include="*.iso" --include-ref=main
   

   • 若需处理所有分支，将--include-ref=main替换为--all-refs。
3. 强制推送重写后的历史（重要：提前通知团队成员，他们需要放弃本地分支重新克隆，因为历史已被修改）：

   git push origin main --force
   

4. 清理本地仓库的冗余对象：

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

5. 远程仓库清理（GitLab端）：
   进入GitLab仓库的「设置」→「仓库」→「清理」，触发仓库垃圾回收，删除不再被引用的旧大文件对象；若无权限，联系管理员操作。

四、关键注意事项 #

• 重写公开分支的历史会影响所有协作成员，必须提前沟通，让大家同步操作，避免代码冲突。
• 所有团队成员都要在本地安装并启用Git LFS，防止后续误将大文件提交到Git仓库。
• 操作前务必备份仓库，避免意外丢失数据。

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