首页/开发/Git 与协作速查/稀疏索引(sparse index)
进阶与大仓实践69 条

稀疏索引(sparse index)

启用后索引只展开稀疏目录的树条目,git status 等命令在超大仓库更快;配合 cone 模式使用,Git 2.34 起趋于稳定。

Git 与协作速查开发更新于 2026-10-12
启用git sparse-checkout init --cone --sparse-index
配置index.sparse=true
查看git ls-files --sparse 展示折叠目录条目

常用示例

常用示例
git sparse-checkout init --cone --sparse-index
git sparse-checkout set services/payment
git config index.sparse
ls -l .git/index | awk '{print $5, $9}'
稀疏索引是性能开关,不改变内容语义;出问题时 disable 稀疏检出即可回到普通索引。

易错点

  • 部分旧版工具(打包脚本、老 IDE)不识别稀疏索引布局,异常时先禁用验证
  • 索引体积与状态命令速度是两个不同指标,优化前先测量基线

数据来源与参考

  • Git 官方文档:git-sparse-checkout(--sparse-index)
  • Git 2.34 Release Notes
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌