如何清理本地仓库已删除的Git LFS文件并仅推送必要文件？

问题根源 #

你的本地仓库历史提交中仍保留着对旧LFS文件的引用，即便你删除文件并提交了新版本，Git LFS推送时仍会尝试上传所有被历史引用的对象。git lfs prune默认不会清理被历史提交引用的对象，因此无法解决问题。

解决步骤 #

1. 强制清理本地未被当前提交引用的LFS对象

默认git lfs prune仅清理30天以上且无任何引用的对象，使用--all参数强制清理所有不被当前分支最新提交引用的LFS文件：

git lfs prune --all

2. 修正LFS跟踪规则

检查并修改.gitattributes文件，只保留需要用LFS跟踪的文件规则，删除不必要的条目。例如原本跟踪所有.iso文件，现在仅保留.zip：

# 只保留需要的跟踪规则
*.zip filter=lfs diff=lfs merge=lfs -text

修改后提交该文件：

git add .gitattributes
git commit -m "Update LFS tracking to only necessary files"

3. 重置仓库历史（彻底清除旧引用）

如果旧提交中仍有大量LFS文件引用，直接推送还是会触发上传，此时可以创建全新的初始提交，抛弃所有旧历史：

# 暂存当前所有文件
git add .
# 创建新的初始提交（允许空提交，确保历史干净）
git commit --allow-empty -m "Clean initial commit with required LFS files"
# 强制推送到远程主分支（覆盖远程仓库）
git push -f origin main

注意：此操作会完全清除远程仓库的旧历史，确认不需要旧提交再执行。

4. 验证并推送

先确认当前分支的LFS文件列表正确：

git lfs ls-files

输出应仅包含你需要保留的大文件，随后执行推送：

git push origin main

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