Git sparse-checkout允许只在工作区检出指定路径，不下载完整历史，节省磁盘与带宽；需先fetch全量对象再checkout生效，推荐启用cone mode并配合.git/info/sparse-checkout配置路径。
Git 的 sparse-checkout 功能允许你只检出仓库中特定子目录或文件路径，而不下载整个仓库历史和全部文件，特别适合超大型单体仓库（如 monorepo）或包含大量二进制资源的项目。它不是“只克隆部分”，而是完整拉取对象（commit、tree、blob），但仅在工作区展开你指定的路径——既保障 Git 操作完整性，又节省磁盘与带宽。
启用 sparse-checkout 并配置过滤规则
从 Git 2.25+ 开始，sparse-checkout 默认支持 cone mode（更高效、更安全），推荐优先使用：
- 初始化空仓库并开启 sparse-checkout：
git init && git remote add origin <url> && git config core.sparseCheckout true - 启用 cone mode（自动优化匹配逻辑，避免通配符陷阱）：
git config core.sparseCheckoutCone true - 编辑 .git/info/sparse-checkout，按行写入要保留的路径（支持目录前缀，不需通配符）：
echo "src/frontend/" >> .git/info/sparse-checkout
echo "package.json" >> .git/info/sparse-checkout
执行局部检出：fetch + checkout（关键两步）
sparse-checkout 不会自动生效，必须显式 fetch 和 checkout 才能应用过滤：
- 先 fetch 全量对象（但不展开工作区）：
git fetch --depth=1 origin main（可加--depth减少历史体积） - 再 checkout 指定分支，此时 Git 仅将
sparse-checkout中定义的路径写入工作区：
git checkout main - 验证效果：
ls只看到src/frontend/和package.json，其他目录不存在（但 Git 内部仍可查 commit、log）
动态调整检出范围（增删路径）
后续想增加或减少检出内容，只需修改 .git/info/sparse-checkout 并重新应用：
- 追加新路径：
echo "scripts/deploy.sh" >> .git/info/sparse-checkout - 移除已检出路径后需清理本地残留：
git read-tree -mu HEAD（强制重读 tree 并更新工作区） - 若误删了不该删的路径，可运行
git checkout -- <path>恢复，或git restore --source=HEAD --staged --worktree <path>
注意事项与常见坑
sparse-checkout 是功能强大但有边界的设计，需注意以下几点：
- 无法跳过
git clone的对象下载（除非用--filter=blob:none或--filter=tree:0配合 partial clone） - 所有 Git 命令（
log、blame、diff）仍可跨全仓库运行，但status和add默认只感知已检出路径 - 若关闭 cone mode，需手动写
!**+路径/规则，易出错；建议始终开启sparseCheckoutCone - CI 环境中务必确保 Git 版本 ≥ 2.25，并显式设置
core.sparseCheckout=true和core.sparseCheckoutCone=true
