如何将现有Git仓库转换为无树克隆以缩减体积？

要在已有的Git仓库上实现类似--filter=tree:0无树克隆的体积缩减效果，且不新增仓库文件，可以按以下步骤操作：

操作步骤 #

• 确认备份完整性：确保你已有的仓库快照备份完整，避免操作过程中数据丢失。
• 配置远程fetch过滤规则：修改当前仓库的远程fetch配置，让后续拉取仅获取提交历史、标签等元数据，不包含树对象和文件内容：

  git config remote.origin.fetch "+refs/heads/*:refs/remotes/origin/* --filter=tree:0"
  

  这条命令会覆盖原有的fetch规则，添加--filter=tree:0过滤条件。
• 清空工作区并清理本地对象：
  1. 删除工作区所有文件（无树状态下工作区为空）：

     git rm -rf .
     

     执行后工作区会被清空，无需提交此操作——我们要的就是无树的状态。
  2. 强制清理本地仓库中不再被引用的树对象和文件内容：

     git gc --prune=now --aggressive
     

     --prune=now会立即清理过期对象，--aggressive会更彻底地优化仓库体积。
• 重置本地分支到远程分支：确保本地分支与远程分支同步，且仅保留元数据：

  git reset --hard origin/<你的分支名>
  

  例如主分支可执行：git reset --hard origin/main

关键注意事项 #

• 正如你提到的，这种无树状态下，任何需要访问特定提交文件内容的操作（比如构建指向特定提交的软件包）都会失败——因为仓库中没有对应的文件数据。如果需要临时恢复某个提交的文件内容，可以使用git fetch --no-filter <目标提交哈希>拉取该提交的完整对象，但这会临时增加仓库体积。
• 操作完成后，后续执行git pull或git fetch时，都会默认遵循--filter=tree:0规则，不会拉取文件内容。

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