disable 是什么
git sparse-checkout disable 退出稀疏检出：恢复完整工作区并关闭稀疏配置，之后 status、构建与全局检索都回到普通仓库行为。稀疏检出用于「只要一部分目录」的大仓库场景，调整关注范围用 set、查看现状用 list；临时要全量内容也不必来回退出进入。注意 disable 会一次性补齐大量文件，磁盘与 IO 会明显波动。
基本信息
| 关闭 | git sparse-checkout disable |
|---|---|
| 调整 | git sparse-checkout set <目录…> 重新限定范围 |
| 查看 | git sparse-checkout list 列出当前范围 |
| 恢复成本 | 与仓库大小和磁盘速度相关，可能较慢 |
| 副作用 | 完整检出后磁盘占用回升 |
| 替代做法 | 临时检索用 git grep，不受工作区范围限制 |
典型使用场景
- 项目收尾：临时稀疏的仓库恢复全量，避免后续构建缺文件
- 全局检索：要搜全仓时先 disable，或改用 git grep 在版本库层面检索
- 依赖装不全：构建需要全部目录时退出稀疏模式
- 排错对照：排查缺文件问题时先确认是否稀疏模式所致
- 模式切换：不再需要省空间策略时统一恢复完整工作区
- 范围微调：只是关注目录变化时用 set，不必退出稀疏模式
常用示例
常用示例
git sparse-checkout list # 查看当前关注范围
git sparse-checkout set services/order # 调整范围，不必退出稀疏模式
git sparse-checkout disable # 关闭稀疏检出，恢复完整工作区
git status --short | head # 观察补齐后的工作区状态行为对照
| 操作 | 效果 | 代价 |
|---|---|---|
| set | 调整关注目录 | 未关注目录的文件被收起 |
| disable | 恢复完整工作区 | 补齐大量文件，磁盘占用回升 |
| git grep | 版本库层面检索 | 不受工作区范围限制 |
| 重新启用 | 再次进入稀疏模式 | 需要重新 init/set 配置范围 |
临时需要全局检索时，可先 disable 或改用 git grep（在版本库层面检索，不受工作区范围限制）。
disable 关闭稀疏配置后，再次启用要重新 init/set：把范围写进文档，避免重新配置时靠记忆。
只为省磁盘的话用 set 缩小范围即可，没必要 disable 后再重新 init，反复切换在大仓库上很慢。