首页/开发/Git 与协作速查/部分克隆的过滤级别
进阶与大仓实践69 条

部分克隆的过滤级别

过滤参数可选 blob:none、blob:limit=<大小>、tree:0:粒度越粗省得越多,但读取时补下载的请求也越多,按使用场景取舍。

Git 与协作速查开发更新于 2026-10-12
blob:none不取任何文件内容(默认常用)
blob:limit=<n>只取小文件,大文件按需
tree:0连树对象也按需,体积更小、请求更多

常用示例

常用示例
git clone --filter=blob:limit=1m https://example.com/repo.git
git clone --filter=tree:0 https://example.com/bigrepo.git
git rev-list --count --filter=blob:none HEAD
CI 做单次构建通常 blob:none 足够;本地长期开发若网络不稳,完整克隆反而顺手。

易错点

  • tree:0 下大量目录遍历会频繁补下载,脚本场景慎用
  • 过滤级别不能直接对已有克隆「降级」,需按官方指引重新克隆或配置远端 filter

数据来源与参考

  • Git 官方文档:git-clone(--filter 取值)
  • Git 官方文档:git-rev-list(--filter 语法)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌