如何初始化Git子模块且不完整检出提交，按需获取部分文件？

解决方案步骤 #

1. 初始化目标子模块 #

先初始化需要处理的子模块，获取它指向的仓库地址和提交哈希：

git submodule init <subdirectory>

2. 克隆子模块仓库但不检出文件 #

使用--no-checkout参数执行子模块更新，这一步会克隆子模块的仓库元数据（历史记录、提交哈希等），但不会将所有文件检出到本地目录：

git submodule update --no-checkout <subdirectory>

3. 配置子模块的稀疏检出规则 #

进入子模块目录，开启稀疏检出并设置你需要的文件路径：

cd <subdirectory>
# 开启稀疏检出，--cone模式是高效的默认配置，适合大多数场景
git sparse-checkout init --cone
# 设置需要保留的文件/目录路径，可多次使用add添加多个路径
git sparse-checkout set foo/bar/baz

4. 检出指定提交的所需文件 #

执行checkout命令，此时Git只会拉取并检出你在稀疏规则中指定的文件：

git checkout

5. 返回顶层仓库 #

完成操作后回到项目根目录即可：

cd ..

关键说明 #

• --no-checkout是核心参数，它让Git仅克隆子模块的仓库历史，而不完整检出所有文件，避免了耗时的大文件拉取。
• 稀疏检出的--cone模式会优化路径匹配逻辑，提升性能；如果需要更复杂的路径规则，可以去掉--cone参数。
• 这种方式完全跳过了完整克隆子模块的过程，直接按需获取所需文件，比先完整克隆再删除多余文件的方案高效得多。

内容的提问来源于stack exchange，提问作者JimEvans