1. 背景在实际开发中有些 Git 仓库体积较大里面可能包含多个项目、模块或平台代码。开发者有时只需要其中某一个目录而不需要完整拉取整个仓库。这时可以使用 Git 的Sparse Checkout功能只检出指定目录同时仍然保留 Git 版本控制能力。适用场景仓库较大只需要其中一个子目录。只想编译或调试某个模块。希望减少本地磁盘占用。希望减少不必要的文件下载。仍然需要保留 Git 分支、提交、拉取、合并等能力。2. 示例目标假设远程仓库地址为http://git-server/group/repo-name.git需要检出的目标目录为target-directory目标分支为main执行完成后本地工作区中只会检出指定目录例如repo-name/ └── target-directory/3. 操作步骤3.1 克隆仓库但不检出文件gitclone--filterblob:none --no-checkout http://git-server/group/repo-name.git进入仓库目录cdrepo-name参数说明参数说明--filterblob:none使用部分克隆先不下载所有文件内容按需下载--no-checkout克隆后不立即检出工作区文件http://git-server/group/repo-name.gitGit 仓库地址3.2 启用稀疏检出gitsparse-checkout init--cone参数说明参数说明sparse-checkoutGit 稀疏检出功能init初始化稀疏检出配置--cone使用目录模式适合按目录检出性能更好3.3 指定需要检出的目录gitsparse-checkoutsettarget-directory例如gitsparse-checkoutsetmodule_a执行后Git 会把稀疏检出范围限制在指定目录内。如果需要检出多个目录可以这样写gitsparse-checkoutsetmodule_a module_b common3.4 检出目标分支gitcheckout main执行完成后本地工作区只会出现指定目录及其下的文件。4. 完整命令示例下面是完整流程gitclone--filterblob:none --no-checkout http://git-server/group/repo-name.gitcdrepo-namegitsparse-checkout init--conegitsparse-checkoutsettarget-directorygitcheckout main如果以示例目录module_a为例gitclone--filterblob:none --no-checkout http://git-server/group/repo-name.gitcdrepo-namegitsparse-checkout init--conegitsparse-checkoutsetmodule_agitcheckout main5. 执行后的效果执行完成后工作区中只会检出指定目录repo-name/ └── target-directory/ ├── ... └── ...其他目录不会出现在本地工作区中。需要注意的是稀疏检出并不是删除远程仓库中的其他目录也不是权限隔离。它只是让本地工作区只显示指定目录。6. 常用补充命令6.1 查看当前稀疏检出目录gitsparse-checkout list6.2 追加检出其他目录gitsparse-checkoutaddanother-directory例如gitsparse-checkoutaddcommon6.3 重新设置检出目录gitsparse-checkoutsetdirectory-adirectory-b注意set会重新设置稀疏检出范围。6.4 恢复完整仓库检出如果后续需要恢复完整仓库可以执行gitsparse-checkout disable7. 注意事项git sparse-checkout适合需要保留 Git 版本控制能力的开发者。--filterblob:none可以减少初始下载体积。--no-checkout可以避免克隆后直接检出完整工作区。--cone适合按目录检出是推荐用法。稀疏检出不是权限控制不能用于防止用户访问其他目录。8. 总结Git 稀疏检出可以让开发者只拉取并检出仓库中的指定目录适合大仓库、模块化项目和只关注部分代码的开发场景。推荐命令模板gitclone--filterblob:none --no-checkout http://git-server/group/repo-name.gitcdrepo-namegitsparse-checkout init--conegitsparse-checkoutsettarget-directorygitcheckout main