如何为多个Git子模块正确使用--reference参数

要基于参考仓库repo_reference初始化新仓库repo的子模块并避免完整克隆，可以按照以下步骤操作：

步骤1：初始化子模块元数据（不克隆内容） #

先进入新仓库目录，执行以下命令加载所有子模块的配置信息，创建子模块目录和本地仓库结构，但不会从远程克隆内容：

cd repo
git submodule init --recursive

步骤2：为每个子模块配置参考仓库并拉取内容 #

通过git submodule foreach --recursive遍历所有已初始化的子模块，为每个子模块指定参考仓库（对应repo_reference里的同名子模块路径），然后拉取内容：

git submodule foreach --recursive '
  # 构建参考仓库中对应子模块的路径
  ref_repo="../repo_reference/$path"
  # 为当前子模块设置远程仓库的参考路径
  git config remote.origin.reference "$ref_repo"
  # 从远程拉取内容（会优先使用参考仓库的本地数据）
  git fetch
'

补充说明（为什么之前的尝试失败） #

• 第一次尝试：git submodule update的--reference参数是传递给子模块的git clone命令，但该参数指向的是主仓库的参考路径，而非子模块对应的参考路径，因此子模块无法复用参考仓库里的子模块数据，只能完整克隆。
• 第二次尝试：$sm_path是Shell变量，但git submodule update不会解析参数中的Shell变量，导致路径被当作字符串repo_reference/$sm_path直接使用，引发仓库不存在的错误。
• 第三次尝试：git submodule foreach --recursive仅对已完成初始化的子模块生效，未初始化的子模块不会被遍历，因此没有任何操作。

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