如何撤销git filter-repo操作，恢复Git仓库文件与历史？

一、撤销错误的Filter-Repo操作 #

Git Filter-Repo执行时会自动将旧分支引用备份到refs/original/路径下，可通过以下步骤恢复：

1. 检查是否存在旧引用备份

git for-each-ref refs/original/

如果输出包含类似refs/original/refs/heads/master的内容，说明有可用备份。

2. 恢复到操作前的仓库状态
   将命令中的master替换为你的主分支名（比如main）：

git reset --hard refs/original/refs/heads/master

3. 清理旧引用备份（可选）
   确认恢复无误后，可删除Filter-Repo生成的备份引用：

git for-each-ref --format="%(refname)" refs/original/ | xargs -n 1 git update-ref -d

如果上述命令找不到refs/original/，可以尝试通过日志恢复：

• 执行git reflog，找到Filter-Repo操作前的commit哈希值
• 执行git reset --hard <commit-hash>恢复到该版本

二、操作错误原因 #

你执行的Filter-Repo命令存在参数格式错误：

git filter-repo --path manuscript/code/.RDataTmp--invert-paths

--invert-paths是独立参数，但你未用空格与路径分隔，导致Git将manuscript/code/.RDataTmp--invert-paths当成了要匹配的路径（该路径不存在），最终仓库历史被清空，只剩空文件夹。

三、正确移除超大历史文件的步骤 #

1. 执行正确的Filter-Repo命令（注意参数间的空格）：

git filter-repo --path manuscript/code/.RDataTmp --invert-paths

该命令会从所有历史提交中移除指定的.RDataTmp文件。

2. 添加远程仓库（如果之前未配置）：

git remote add origin <你的GitHub仓库URL>

3. 强制推送重写后的历史（修改历史记录必须用--force）：

git push origin master --force

（主分支为main则替换为main）

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