很多人踩过的 Git 大坑：只用 git rm 删除文件，看似删干净了，切换分支、翻看历史、拉取代码后文件又会重现。

因为普通删除只会抹掉「最新版本」，文件依然藏在所有提交记录、新旧分支、远程仓库历史里。

今天分享彻底根治方案：一键删除文件/文件夹，清空本地+远程所有分支、全部历史提交记录，彻底从仓库剔除痕迹✨

❌ 无效删除（千万别只用这个）

仅删除工作区和暂存区，历史记录完全保留，隐患极大：

# 普通删除，治标不治本
git rm 文件名
git commit -m "删除文件"
git push

✅ 终极方案：全仓库彻底清除（全分支+全历史）

适用场景：误传大文件、敏感配置、隐私密钥、冗余资源，需要彻底抹除所有痕迹

前置必做：备份整个仓库！！！（操作不可逆，会重写仓库提交历史）

方法一：官方推荐 git-filter-repo（速度快、稳定、优先用）

1、提前安装工具（二选一）

# Windows/Linux
pip install git-filter-repo
# Mac
brew install git-filter-repo

2、彻底删除指定文件（根目录文件直接写名称）

# 语法：删除单个文件
git filter-repo --force --invert-paths --path 你的文件名

# 示例：删除 mcaddon 文件
git filter-repo --force --invert-paths --path sophisticangel.mcaddon

3、彻底删除整个文件夹（加路径即可）

git filter-repo --force --invert-paths --path 文件夹名/

方法二：原生 Git 命令（无 Python 环境兼容）

适配所有 Git 版本，无需额外安装工具

# 删除单个文件
git filter-branch --force --index-filter 'git rm --cached --ignore-unmatch 文件名' --prune-empty --tag-name-filter cat -- --all

# 删除整个文件夹（加 -r 递归删除）
git filter-branch --force --index-filter 'git rm -r --cached --ignore-unmatch 文件夹名/' --prune-empty --tag-name-filter cat -- --all

🧹 本地垃圾清理（释放仓库空间）

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

🚀 强制同步远程（关键步骤）

# 推送所有分支
git push origin --force --all
# 推送所有标签（如有）
git push origin --force --tags

✅ 验证是否彻底删干净

无任何输出，代表全部分支、所有历史已彻底清除

git log --all -- 你的文件名

⚠️ 高频避坑重点

1、强制推送会重写远程历史，团队项目务必提前同步，所有成员需删除旧仓库、重新克隆

2、禁止在备份仓库执行推送操作，必须在原始项目根目录操作

3、出现 origin 不是git仓库 报错，先绑定远程仓库：

git remote add origin 你的仓库地址

4、敏感文件删除后，建议重置密钥、密码等信息，规避缓存泄露风险

简单几步，彻底告别 Git 历史残留文件，仓库瘦身+安全清理一步到位💪