git 删除历史提交文件 前言在软件开发中，有时候因为各种原因忘记完善 .gitignore 文件导致提交了很多不必提交的文件， 后期编译导致大量的文件发生变更提交。针对这种情况，需要从git所有提交中删除这些变更。介绍如果你想从 Git 仓库的所有提交历史中删除特定文件，可以使用 git filter-repo 工具（推荐）或 git filter-branch（较旧的方法）。这将重写整个提交历史，因此请确保在操作前备份仓库或创建一个新分支操作为了数据安全， 建议操作前备份数据！！！使用 git filter-repo(t推荐)首先安装 git filter-repo（如果尚未安装），然后执行以下命令:# 安装 git filter-repo（根据你的系统选择合适的安装方式） # Ubuntu/Debian: sudo apt-get install git-filter-repo # macOS (Homebrew): brew install git-filter-repo # Windows (Git for Windows): git filter-repo --version # 通常已包含 # 从所有提交中删除指定文件或目录 git filter-repo --invert-paths --path path/to/file1 --path path/to/dir/ # 示例：删除所有提交中的 secrets.txt 和 logs/ 目录 git filter-repo --invert-paths --path secrets.txt --path logs/ # 强制推送至远程仓库（注意：这会覆盖远程历史） git push origin --force --all 使用 git filter-branch(旧方法)如果无法使用 git filter-repo，可以使用 git filter-branch（但性能较差）：# 从所有提交中删除指定文件, 文件夹需要带 -r git filter-branch --force --index-filter 'git rm -r --cached --ignore-unmatch path/to/file' \ --prune-empty --tag-name-filter cat -- --all # 强制推送至远程仓库 git push origin --force --all处理复杂路径（含空格或特殊字符） 如果路径中包含空格或特殊字符，需要用双引号或转义字符处理：git filter-branch --force --index-filter 'git rm --cached --ignore-unmatch "path/to/my dir" path/to/file\ with\ space.txt' \ --prune-empty --tag-name-filter cat -- --all操作后的清理无论使用哪种方法，操作后都应执行以下命令清理残留对象并减小仓库体积：git for-each-ref --format='delete %(refname)' refs/original | git update-ref --stdin git reflog expire --expire=now --all git gc --prune=now --aggressive 错误处理fatal: delete refs/original/refs/heads/doorFace_dual_xct: expected SP but got: ?问题原因 git for-each-ref 默认输出原始引用名，若引用名中包含空格、问号等特殊字符，会破坏 git update-ref 期望的命令格式（delete ）。解决方案 使用更健壮的引用名处理方式，避免特殊字符干扰：# 使用 --shell 选项确保引用名被正确转义 git for-each-ref --shell --format='delete %(refname)' refs/original | sh 备选方案如果上述方法仍有问题，可以手动查看并删除 refs/original/ 下的引用：# 查看所有 refs/original/ 引用 git show-ref | grep refs/original/ # 手动删除（逐个执行，替换 <refname> 为实际引用名） git update-ref -d refs/original/<refname> 操作实例建议操作之前将所有.gitignore完善， 然后提交。确保缓存区无数据。# 第一步 git filter-branch --force --index-filter 'git rm -r --cached --ignore-unmatch .idea/ app/src/main/protogen/ \ app/src/generated/ app/src/main/java/com/aqhby/doorface/facehelper/facedb/autogen/ app/release/ app/.cxx/' \ --prune-empty --tag-name-filter cat -- --all # 第二步 git show-ref | grep refs/original/ # 第三步 git update-ref -d refs/original/refs/heads/doorFace_Dual_xct git update-ref -d refs/original/refs/heads/master git update-ref -d refs/original/refs/remotes/origin/doorFace_Dual_xct git update-ref -d refs/original/refs/remotes/origin/doorFace_xct_branch git update-ref -d refs/original/refs/remotes/origin/master # 第四步 # 安全清理引用 git for-each-ref --shell --format='delete %(refname)' refs/original | sh # 清除 reflog 并垃圾回收 git reflog expire --expire=now --all git gc --prune=now --aggressive # 查看历史提交文件， 文件已经不存在。 结束