如何配置稀疏子模块检出，使后续克隆自动继承该配置？

可行。Git在2012年后的版本（尤其是Git 2.25+及后续迭代更新）已经支持将子模块的稀疏检出配置纳入仓库共享，让其他用户克隆/拉取仓库时自动继承该设置，解决了早年无法共享稀疏检出配置的问题。

具体实现步骤： #

1. 添加并初始化子模块

   • 添加子模块到父仓库：

     git submodule add <子模块仓库地址> <本地存放路径>
     

   • 进入子模块目录：

     cd <本地存放路径>
     

2. 为子模块配置稀疏检出

   • 启用稀疏检出功能：

     git config core.sparseCheckout true
     

   • 创建稀疏检出规则文件（命名为.gitsparse，该文件会提交到父仓库用于共享），写入需要保留的路径示例：

     src/
     docs/README.md
     utils/common/
     

   • 应用规则拉取对应内容：

     git read-tree -mu HEAD
     

3. 共享稀疏检出配置给其他用户

   • 回到父仓库，提交子模块目录下的.gitsparse文件：

     cd ..
     git add <子模块本地路径>/.gitsparse
     git commit -m "Add sparse checkout config for submodule"
     

   • 在父仓库根目录创建hooks/post-submodule-update钩子脚本，自动为子模块应用稀疏检出规则：

     #!/bin/bash
     git submodule foreach --recursive '
       if [ -f .gitsparse ]; then
         git config core.sparseCheckout true
         cp .gitsparse .git/info/sparse-checkout
         git read-tree -mu HEAD
       fi
     '
     

   • 给脚本添加执行权限，并提交到父仓库：

     chmod +x hooks/post-submodule-update
     git add hooks/post-submodule-update
     git commit -m "Add post-submodule-update hook for sparse checkout"
     

   • 其他用户克隆父仓库后，只需执行以下命令启用钩子并拉取子模块：

     git config core.hooksPath hooks
     git submodule update --init --recursive
     

关于2012年的旧结论 #

2012年的Git版本中，稀疏检出的配置仅存储在本地的.git/info/sparse-checkout文件中，属于本地工作区状态，无法通过Git提交共享给其他用户，因此当时确实无法实现默认继承的需求。但后续Git版本通过扩展钩子功能、支持自定义配置文件共享等方式，填补了这个功能缺口。

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