Git嵌套子模块新增后执行递归更新无法拉取新子模块如何解决

git submodule update --init --recursive 的默认逻辑是：严格对齐当前父仓库提交记录里绑定的各层级子模块commit哈希，初始化本地还没拉取的子模块，不会主动拉取子模块自身的最新提交。
当子模块B新增嵌套子模块C2后，如果你本地仓库A绑定的B的commit哈希还是B新增C2之前的旧版本，本地B目录里的.gitmodules文件根本没有C2的配置记录，命令自然识别不到C2的存在，拉取失败。

按顺序执行以下步骤即可：

1. 先在仓库A的根目录执行带远程同步参数的子模块更新命令，拉取所有子模块的最新提交、同步嵌套子模块配置：

   git submodule update --remote --init --recursive
   

   这里加--remote参数是核心，会让Git拉取每个子模块配置的跟踪分支的最新提交，而不是停留在父仓库绑定的旧commit上，执行后本地B子模块会更新到包含C2配置的版本，自动识别并拉取C2。

2. 如果上面的命令执行完还是没看到C2，手动同步B子模块的最新代码：
   • 进入B子模块的本地路径：cd <B子模块在A里的相对路径>
   • 拉取B的最新远程代码：git pull
   • 回到A的根目录：cd -
   • 重新执行递归初始化命令：git submodule update --init --recursive
3. 如果是团队协作场景，做完上面操作后必须同步更新A仓库的子模块指针，不然其他协作者永远拉不到C2：
   • 在A根目录执行命令把B的指针更新到最新版本：git submodule update --remote B
   • 暂存B子模块的指针变动：git add <B子模块在A里的相对路径>
   • 提交并推送到A的远程仓库：

     git commit -m "chore: update submodule B to support new nested submodule C2"
     git push
     

   其他协作者拉取A的最新提交后，再执行git submodule update --init --recursive就能正常拉取C2了。

• 不要反复执行不带--remote的git submodule update --init --recursive，只要A仓库绑定的B还是旧commit，跑多少次都识别不到C2。
• 如果拉取过程中报权限错误，先进入B子模块查看.gitmodules文件里C2的仓库地址配置是否正确，确认你账号有C2仓库的拉取权限。

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