如何保留Stars并减小含旧Release引用的GitHub仓库体积？

问题根源 #

核心问题在于：你通过git rebase清理了主分支的大文件，但之前创建的Release会保留对旧提交的引用，GitHub会持续存储这些被引用的旧提交（包含大文件），导致克隆仓库时仍会拉取这些冗余数据。

具体解决步骤 #

1. 删除关联旧提交的Release #

删除所有基于rebase前代码创建的Release是必须的——这些Release是旧提交的“锚点”，只要它们存在，GitHub就不会清理对应的旧提交。操作后可以基于当前干净的主分支重新创建Release，保留版本记录功能。

2. 用git filter-repo彻底清理历史大文件 #

仅删除Release还不够，需要彻底从仓库历史中移除大文件的痕迹：

• 先安装git filter-repo（官方推荐替代git filter-branch的工具，可通过pip install git-filter-repo安装）
• 克隆仓库的镜像版本（确保能完整操作所有历史）：

  git clone --mirror https://github.com/SUSYUSTC/MathTranslate.git
  

• 进入镜像仓库目录，执行命令移除目标大文件（替换<大文件路径>为实际的文件名或路径，比如dist/large_executable.exe）：

  cd MathTranslate.git
  git filter-repo --path <大文件路径> --invert-paths
  

• 强制推送到远程仓库（这会重写所有提交历史，务必提前通知仓库贡献者，让他们重新克隆仓库）：

  git push --force
  

3. 等待GitHub垃圾回收 #

完成上述操作后，GitHub不会立刻清理旧的提交对象，通常需要等待1-7天自动触发垃圾回收。如果着急，可以联系GitHub支持请求手动触发，但一般无需额外操作。

4. 后续预防措施 #

• 在.gitignore中添加可执行文件、大二进制文件的规则，避免误提交
• 如果确实需要存储大文件，使用Git LFS管理，避免污染仓库历史

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