如何克隆并仅使用Git子模块的部分内容以避免全量下载？

首先明确：你想直接在.gitmodules里指定仓库子路径的方式不可行，因为Git子模块的url字段必须指向完整的Git仓库地址，无法直接定位到仓库内的某个子目录。不过有几种替代方案可以实现仅拉取所需部分内容的需求：

方案一：子模块 + 稀疏检出（Sparse Checkout） #

这是最贴近你原有子模块思路的方案，通过配置Git稀疏检出，让子模块只拉取你需要的目录：

1. 先按正常方式配置子模块的.gitmodules文件：

[submodule "external/bigrepo"]
    path = external/bigrepo
    url = ../../BigDevs/bigrepo.git

2. 初始化子模块但暂不克隆完整内容：

git submodule init

3. 进入子模块目录，启用稀疏检出并指定需要的路径：

cd external/bigrepo
# 启用稀疏检出
git config core.sparseCheckout true
# 指定要拉取的子路径（Git 2.25+ 可用该简洁命令）
git sparse-checkout set "little/piece/of/it/"
# 拉取对应分支的内容
git pull origin <目标分支名>

4. 回到父仓库，提交.gitmodules和子模块的状态。其他开发者克隆仓库后，只需执行以下命令即可同步稀疏配置：

git submodule update --init
cd external/bigrepo
git sparse-checkout set "little/piece/of/it/"
git pull origin <目标分支名>

方案二：使用Git Subtree #

如果不需要保留子模块的独立仓库关系，可以用Git Subtree直接将目标子目录合并到当前仓库，开发者克隆时只会拿到所需内容：

1. 添加远程仓库地址：

git remote add bigrepo ../../BigDevs/bigrepo.git

2. 将目标子目录拉取到本地指定路径（--squash可选，用于压缩历史提交）：

git subtree add --prefix=external/bigrepo bigrepo <目标分支名> --squash

3. 后续需要更新内容时，执行：

git subtree pull --prefix=external/bigrepo bigrepo <目标分支名> --squash

方案三：拆分上游仓库（最优解，若有权限） #

如果你能操作上游的bigrepo，建议将little/piece/of/it/目录拆分为独立的小型Git仓库，之后直接将这个小仓库作为子模块引入。这种方式最简洁，所有开发者只会拉取所需的小仓库内容，无需额外配置。

内容的提问来源于stack exchange，提问作者All The Rage