组装Git嵌套子模块后克隆失败，求解决方案

你的问题核心在于子模块引用了本地路径而非可共享的远程仓库，加上NFS环境下Git的特殊性，导致克隆时无法找到子模块对应的commit哈希。下面是具体的分析和解决方案：

为什么你的测试用例会失败？ #

当你在msub的m1子模块工作区里用realpath添加m2、m3时，Git会在m1的本地.gitmodules文件里记录它们的本地绝对路径。但当你克隆msub到新目录时，新环境里这个绝对路径要么不存在，要么不是一个可被Git访问的共享仓库，所以Git无法拉取对应的commit，就会抛出not our ref的致命错误。

而且你提到不能直接修改原始的m1仓库，所以在m1本地添加子模块的方案也不可行——我们需要在共享仓库msub里独立维护嵌套子模块的结构，不影响原始仓库。

解决方案：用共享远程仓库重构子模块结构 #

1. 先为所有独立仓库创建裸远程仓库（适配NFS性能） #

NFS上Git性能差的主要原因是工作区的大量小文件IO，用裸仓库作为远程可以大幅提升性能。在NFS上创建所有子模块的裸仓库：

# 创建m1的裸远程仓库
mkdir -p /nfs/shared-git/m1.git && cd /nfs/shared-git/m1.git
git init --bare

# 把本地m1仓库推到远程
cd /path/to/your/local/m1
git remote add origin /nfs/shared-git/m1.git
git push -u origin main

# 同理处理m2和m3
mkdir -p /nfs/shared-git/m2.git && cd /nfs/shared-git/m2.git && git init --bare
cd /path/to/your/local/m2 && git remote add origin /nfs/shared-git/m2.git && git push -u origin main

mkdir -p /nfs/shared-git/m3.git && cd /nfs/shared-git/m3.git && git init --bare
cd /path/to/your/local/m3 && git remote add origin /nfs/shared-git/m3.git && git push -u origin main

2. 重构msub仓库的嵌套子模块结构 #

这次我们用远程仓库地址添加子模块，并且在msub内部维护嵌套关系，不修改原始的m1仓库：

# 重新创建msub仓库（清理之前的测试环境）
rm -rf msub && mkdir msub && cd msub
git init
date > d.txt && git add d.txt && git commit -m "Initial commit with d.txt"

# 添加m1作为顶级子模块（用远程地址）
git submodule add /nfs/shared-git/m1.git m1

# 进入m1子模块工作区，添加m2和m3作为嵌套子模块
cd m1
git submodule add /nfs/shared-git/m2.git m2
git submodule add /nfs/shared-git/m3.git m3

# 把嵌套子模块的配置提交到msub仓库（注意：这不会修改原始m1仓库，只在msub的m1子模块目录下记录配置）
git add .gitmodules m2 m3
git commit -m "Add nested submodules m2 and m3 under m1"

# 返回msub根目录，提交顶级子模块的变更
cd ..
git add .gitmodules m1
git commit -m "Add m1 with nested submodules m2, m3"

3. 测试克隆 #

现在用--recursive克隆msub，就能成功拉取所有嵌套子模块了：

git clone --recursive /path/to/your/local/msub msub1

额外注意事项 #

• NFS性能优化：裸仓库避免了工作区的文件IO，克隆和拉取速度会比普通仓库快很多；如果还是慢，可以尝试减少子模块的深度，或者用git clone --depth 1做浅克隆（如果不需要完整历史）。
• 共享地址有效性：确保所有用户都能访问NFS上的裸仓库路径（权限设置正确），如果是跨机器的场景，可以用SSH或者HTTP地址替代本地NFS路径。
• 分步克隆排查：如果--recursive还是失败，可以尝试分步操作：

  git clone /path/to/msub msub1
  cd msub1
  git submodule update --init --recursive
  

  这样能更清晰地看到哪个子模块出了问题。

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