从 Git 仓库中永久删除文件或目录

我们常用的 git rm 仅对 Working Tree 构成影响，如果想永久的删除仓库中的文件或目录，那么就要用到 git filter-branch 命令了。git filter-branch 会检索整个 Commit 历史，逐一改写 Commit Object，重构整个 Tree。

git filter-branch --tree-filter 'rm -rf path/folder' HEAD
git filter-branch --tree-filter 'rm -f path/file' HEAD

也可以指定 检索的 Commit 历史的范围：

git filter-branch --tree-filter 'rm -rf path/folder' 347ae59..HEAD

最后，不要忘了向仓库强制推送所有的变化：

git push origin master --force

执行 git filter-branch 命令后，已经标记为删除的 Object 在本地仓库中要到过期后才会解除关联和进行垃圾回收。检查哪些 tags 和 branch 引用了这些 Object：

git for-each-ref --format='delete %(refname)' refs/original

如果想立即解除关联，执行垃圾回收，可以这么做：

git for-each-ref --format='delete %(refname)' refs/original | git update-ref --stdin
git reflog expire --expire=now --all
git gc --prune=now

接下来，就是强制推送到仓库了:

git push origin --force --all
git push origin --force --tags

不到迫不得已，不要轻易使用 git filter-branch，因为它重构了整个 Tree，所以每个开发人员都需要重新克隆仓库到本地，对于有很多开发者参与的大型项目来说，这么做会给很多人带来麻烦，与其事后对仓库内容进行修正，不如伊始就对每个 Commit 慎之又慎。