Git切换为不同仓库结构的子模块时出现报错如何解决

Git主仓库会为每个子模块存储一个称为gitlink的索引对象，记录对应子模块应当检出的固定提交SHA，该配置独立于.gitmodules文件。你仅修改了子模块的远程仓库地址，没有更新主仓库索引中存储的子模块提交SHA，因此Git依然会尝试从新的子模块仓库拉取仅存在于原子模块中的旧提交，导致报错。

• 确认你已经完成以下清理操作：
  • 修改.gitmodules为新子模块B的URL
  • 删除缓存目录：rm -rf .git/modules/<子模块路径>
  • 删除工作区子模块目录：rm -rf <子模块路径>
• 强制添加新子模块覆盖原有路径记录：

  git submodule add --force <子模块B的远程URL> <子模块路径>
  

• 进入子模块目录，切换到你需要使用的B仓库的分支/提交：

  cd <子模块路径>
  git checkout <目标分支名/提交SHA>
  

• 回到主仓库根目录，更新索引中的gitlink记录并提交修改：

  cd <主仓库根目录>
  git add .gitmodules <子模块路径>
  git commit -m "替换子模块A为子模块B"
  

• 最后执行子模块更新验证：

  git submodule sync
  git submodule update
  

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