Git克隆过慢：如何移除历史中已删除的大文件？

嘿，我来帮你搞定这个困扰！你已经定位到是历史里的误推大文件搞的鬼，而且这些文件不在任何现有分支里，那可以从彻底清理历史和克隆时排除两个方向来解决，看你需求选：

一、彻底从Git历史移除大文件（适合团队统一更新仓库） #

这个方法会永久删除Git历史里的大文件，从根源解决克隆慢的问题，但要注意会重写仓库历史，得和团队同步好。

步骤： #

1. 先备份仓库！ 这步绝对不能省，避免操作失误丢数据：

   cp -r your-repo-folder your-repo-folder-backup
   

2. 安装git filter-repo（Git官方推荐替代老旧的git filter-branch的工具，更安全高效）：
   • Ubuntu/Debian：sudo apt install git-filter-repo
   • macOS：brew install git-filter-repo
   • 其他系统可通过包管理器安装，实在不行也能从官方源码部署。
3. 进入仓库目录，先确认大文件的完整路径（你之前的命令已经拿到哈希，转成路径）：

   git rev-list --objects --all | grep <你查到的大文件哈希>
   

   输出会类似abc12345 path/to/huge-file.iso，后面的就是文件路径。
4. 用git filter-repo删除这个大文件（多个文件就加多个--path参数）：

   git filter-repo --invert-paths --path path/to/huge-file.iso
   # 多个文件的例子：
   # git filter-repo --invert-paths --path file1.zip --path folder/big-file.tar.gz
   

5. 强制推送到远程仓库（这会覆盖远程的历史，务必提前和团队沟通！）：

   git push origin --force --all
   

6. 清理本地和远程的冗余对象：
   • 本地清理：

     git reflog expire --expire=now --all && git gc --prune=now --aggressive
     

   • 远程仓库：比如GitHub、GitLab这类平台，一般会自动定期清理冗余对象，也可以去仓库设置里找“垃圾回收”选项手动触发。

二、克隆时排除大文件（适合个人临时使用，不修改仓库历史） #

如果不想动远程仓库的历史，只是自己克隆时不想下载这些大文件，可以用以下两种方法：

方法1：稀疏检出（精准指定要下载的目录） #

这种方法只拉取你需要的文件路径，完全避开大文件所在的路径：

# 1. 初始化本地仓库
git init my-repo && cd my-repo
# 2. 添加远程仓库地址
git remote add origin <你的远程仓库URL>
# 3. 启用稀疏检出功能
git config core.sparseCheckout true
# 4. 添加你需要的路径（比如只拉src目录和README）
echo "src/" >> .git/info/sparse-checkout
echo "README.md" >> .git/info/sparse-checkout
# 5. 拉取代码
git pull origin master

方法2：浅克隆（只拉取最近N次提交） #

如果大文件是很久以前的提交里的，浅克隆只拉取最近的提交历史，也能避开大文件：

# 只拉取最近1次提交的历史，数字可以改大一点，比如10
git clone --depth 1 <你的远程仓库URL>

不过浅克隆会丢失早期的历史记录，适合只需要最新代码的场景。

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