适用范围与准备

适用于 Git 仓库可以读取提交,但工作目录中缺少一部分应有目录的情况。先保存未提交修改并确认当前分支;本篇针对已启用的稀疏检出,不把子模块、LFS 指针或不同分支的问题混在一起。

先区分原因

稀疏检出可以让当前提交中的部分路径不出现在工作目录。文件不在磁盘上不等于服务器没传好;但部分克隆还可能需要按需获取对象,不能据此断言后续操作完全不联网。

按顺序操作

  1. 在仓库内运行 git status --short,先处理需保留的修改。再用 git ls-tree 检查缺失目录是否确实存在于 HEAD;没有对应路径时先查分支与提交。
  2. 运行 git sparse-checkout list 和 git config --get core.sparseCheckoutCone。未启用稀疏检出会有不同提示,不要为了排查随手开启。
  3. 若明确启用了 cone 模式,记录原目录清单;用 git sparse-checkout add PATH/TO/DIR 添加需要的目录。占位路径相对仓库根,必须替换为 HEAD 中存在的目录。
  4. add 在原范围上增加;set 会重新设定范围,不能当成相同操作。non-cone 模式使用的是模式规则,不直接套用本篇目录示例。
  5. 若确实需要完整工作区,并确认磁盘容量和本地修改已保存,可使用 git sparse-checkout disable;大型或部分克隆仓库应先考虑展开代价。
先查询,再按上文条件选择操作
git status --short
git ls-tree --name-only HEAD
git sparse-checkout list
git config --get core.sparseCheckoutCone
仅适用于已开启 cone 模式;替换目录占位值
git sparse-checkout add PATH/TO/DIR

怎样确认有效

确认目标目录出现、文件属于预期提交,且 git status 没有意外删除或修改。工作区恢复不等于子模块已初始化或 LFS 大文件已下载,遇到这些情况转对应教程。

无效时恢复与下一步

若需收回本次增加的目录,先保存其修改,再按原模式及完整清单使用 set 恢复;不清楚原模式就停止自动恢复。不要用 reset --hard 或清理未跟踪文件来掩盖目录缺失。