Git裸仓库执行filter-branch后无法删除refs/original的解决方案咨询

你遇到的fatal: this operation must be run in a work tree错误，是因为误将系统rm命令当作Git命令执行，或是未进入裸仓库根目录操作。裸仓库没有工作树，直接用系统命令操作文件即可：

1. 正确删除filter-branch备份目录 #

进入裸仓库根目录（通常是.git结尾的文件夹，比如myrepo.git），执行系统删除命令：

rm -rf refs/original

这是直接操作文件系统的命令，不会触发Git的工作树检查。

2. 清理裸仓库无用对象 #

针对裸仓库，执行以下命令完成垃圾回收（无需单独执行git fsck或git repack，git gc已包含这些操作）：

git prune --expire now
git gc --aggressive --prune=now

• git prune --expire now：立即清理所有不再被引用的松散对象
• git gc --aggressive --prune=now：深度整合仓库对象，彻底清理垃圾数据，比普通git gc更彻底

后续注意事项 #

• 你多次执行git filter-branch修改了仓库历史，所有克隆过该仓库的本地副本需重新克隆，或执行git fetch --all --prune后将本地分支强制重置到远程分支（比如git reset --hard origin/main），否则会出现历史不一致问题。
• 下次清理多个文件/文件夹时，建议一次性在git filter-branch的--index-filter里完成，避免重复操作：

  git filter-branch -f --index-filter '
    git rm --cached --ignore-unmatch junk/bigfile1 junk/bigfile2 &&
    git rm -rf --cached --ignore-unmatch Folder-I-Want-To-Remove
  ' -- --all
  

  用&&串联多个删除命令，仅执行一次filter-branch，减少备份冗余。

内容的提问来源于stack exchange，提问作者blue22