首页/开发/Git 与协作速查/git sparse-checkout 稀疏检出
进阶与大仓实践69 条

git sparse-checkout 稀疏检出

只检出仓库的一部分目录到工作区(锥形模式默认按目录),其余文件仍留在版本库中;大仓开发常与部分克隆搭配使用。

Git 与协作速查开发更新于 2026-10-12
启用git sparse-checkout init --cone
设置目录git sparse-checkout set <目录…>
查看git sparse-checkout list

常用示例

常用示例
git clone --filter=blob:none --sparse https://example.com/monorepo.git
cd monorepo
git sparse-checkout set services/payment libs/common
git status
稀疏检出改变的是工作区范围,提交与合并仍在完整仓库上进行;适合「只改一个服务」的日常工作流。

易错点

  • 切换分支时工作区按稀疏规则更新,缺文件报错先确认是否被排除
  • 稀疏目录外的文件不存在于工作区,脚本里写死全路径会莫名失败

数据来源与参考

  • Git 官方文档:git-sparse-checkout
  • GitHub Docs:Sparse checkout(大仓开发)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌