从 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 慎之又慎。

Comments