如何在Git中仅克隆子模块的指定子目录作为依赖？

Git原生子模块默认会克隆整个仓库，要实现只拉取子模块里的指定目录，需要结合**稀疏检出（Sparse Checkout）**功能，具体步骤如下：

1. 初始化子模块（先添加完整子模块） #

在主仓库根目录执行命令，添加依赖仓库作为子模块：

git submodule add <依赖仓库的Git地址> dependency-repository

这一步会先克隆整个依赖仓库到dependency-repository目录，同时在主仓库生成.gitmodules文件。

2. 配置子模块的稀疏检出 #

进入子模块目录，开启稀疏检出功能：

cd dependency-repository
git config core.sparseCheckout true

然后在子模块的.git/info/sparse-checkout文件中，写入需要保留的目录路径：

echo "include/" >> .git/info/sparse-checkout

3. 更新子模块，只拉取指定目录 #

执行以下命令让Git应用稀疏检出配置，移除不需要的文件：

git read-tree -mu HEAD

此时子模块目录下就只会保留include目录，其他目录会被删除。

4. 提交主仓库的配置变更 #

回到主仓库根目录，提交子模块的配置变更：

cd ..
git add .gitmodules dependency-repository
git commit -m "Add dependency submodule with sparse checkout for include directory"

后续克隆主仓库的注意事项 #

其他人克隆主仓库时，需要执行以下命令来初始化子模块并应用稀疏检出：

git clone <主仓库地址>
cd <主仓库目录>
git submodule init
git submodule update --remote

进入子模块目录后，确认稀疏检出配置已生效，如果没生效，重新执行步骤2和3的配置命令即可。

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