远程仓库含数万分支时，如何加速单个Git分支的克隆？

为什么单分支浅克隆依然缓慢？ #

核心原因在于Git克隆的初始引用枚举流程，以及Gerrit仓库的特殊结构：

• Git默认克隆时，即使添加--single-branch参数，仍会先请求服务器返回所有引用（refs）的完整列表。当你的仓库有3万+分支，再加上Gerrit自动生成的大量refs/changes/*变更引用，这个引用列表的传输、解析会占用大量时间，这就是你看到“Cloning into 'manifest'...”阶段长时间停留的主要原因。
• --single-branch仅限制后续拉取指定分支的提交数据，但无法跳过初始的全引用枚举步骤；--depth 1只是减少提交历史的深度，对引用枚举的开销没有影响。

优化方案 #

1. 优化Git克隆命令参数 #

使用以下命令，从两个维度减少开销：

time git clone -b branch_ci --single-branch --depth 1 --no-tags --filter=blob:none http://<gerrit-host>/manifest.git

• --no-tags：跳过所有标签引用的枚举与拉取，减少引用列表的规模。
• --filter=blob:none：告诉Git服务器仅传输提交对象和树对象，不传输文件内容（大幅降低数据传输量）。克隆完成后，若需要获取default.xml文件，执行：

  git checkout HEAD -- default.xml
  

2. 直接通过Gerrit API获取单个文件 #

如果你的需求只是获取branch_ci分支下的default.xml，完全可以绕过Git克隆，直接调用Gerrit的REST API获取文件内容：

curl http://<gerrit-host>/projects/manifest/branches/branch_ci/files/default.xml/raw

这个方法避免了所有Git克隆的开销，速度会得到数量级的提升。

3. 升级Git版本 #

确保使用Git 2.25及以上版本，后续版本对--single-branch、--filter等参数的实现做了性能优化，尤其是在处理大规模引用列表时的效率提升。

关于Git分支实现的疑问 #

Git的分支本质是指向提交的轻量引用，本身存储和管理的成本极低。你遇到的性能问题并非分支实现导致，而是Git默认克隆流程中全引用枚举的设计在引用规模极大时的瓶颈。通过上述参数可以规避这个瓶颈。

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