221-git不小心提交大文件怎么办

如果git不小心提交了一个巨大的文件怎么办呢

如果是commit，当然是没关系了

但是如果是push了，那该怎么办

如果你已经 push 了一个巨大的文件到 Git 仓库，可以按以下方法处理：

1. 删除本地提交（如果还没被其他人拉取）

git reset --hard HEAD~1  # 回退到上一个提交（会丢失修改）
git push --force         # 强制推送，覆盖远程

如果提交了多个错误提交，可以调整 HEAD~1 为 HEAD~N。

---

2. 使用 git filter-repo 彻底删除文件

即使 reset --hard，文件仍然会留在 Git 历史中，占用空间。如果你需要彻底移除，可以使用 git filter-repo：

git filter-repo --path <大文件路径> --invert-paths
git push --force --all

可能需要先安装 git-filter-repo，例如：

sudo apt install git-filter-repo  # Ubuntu
brew install git-filter-repo       # macOS

---

3. 使用 BFG Repo-Cleaner（另一种方法）

如果 git filter-repo 不能使用，可以试试 BFG：

bfg --delete-files <大文件路径>
git reflog expire --expire=now --all
git gc --prune=now
git push --force --all

BFG 需要 下载 JAR 文件 并运行 java -jar bfg.jar。

---

4. 如果远程仓库拒绝 force push

如果 git push --force 被远程仓库策略拒绝：

• 联系管理员修改策略，或者
• git revert 创建一个新的撤销提交：

  git revert <提交ID>
  git push
  

  这样不会修改历史，但大文件仍然存在。

---

5. 防止未来提交大文件

如果你不想再次误提交大文件，可以配置 .gitignore 或 Git 钩子：

• 添加 .gitignore，避免误提交：

  *.zip
  *.mp4
  *.iso
  

• 使用 pre-commit 钩子（自动阻止大文件提交）：

  echo 'if git rev-parse --verify HEAD >/dev/null 2>&1; then BASE=HEAD; else BASE=; fi
  if [ $(git diff --cached --numstat | awk "{s+=\$1} END {print s}") -gt 500000 ]; then
    echo "提交文件太大，请删除后重新提交！"
    exit 1
  fi' > .git/hooks/pre-commit
  chmod +x .git/hooks/pre-commit
  

---

如果你的仓库是 多人协作的，一定要慎用 --force，以免影响他人。可以先拉取所有更新 (git pull --rebase)，然后再操作。