主仓库切换分支后Git子模块无法切换对应API仓库的问题咨询

问题本质 #

你的场景核心是同一子模块目录在主仓库不同分支绑定了不同远程仓库，切换分支后Git默认不会自动更新子模块的远程配置，仍沿用之前的缓存地址，导致找不到对应提交。解决关键在于利用主仓库不同分支的.gitmodules差异，配合子模块的初始化命令强制刷新远程地址。

手动操作步骤 #

每次切换主仓库分支后，执行以下命令即可让API子模块指向对应远程：

1. 强制解除当前子模块的本地关联，清除旧配置缓存：

   git submodule deinit -f API
   

2. 重新初始化子模块，读取当前分支.gitmodules里的正确远程地址：

   git submodule init API
   

3. 拉取对应远程仓库的指定提交：

   git submodule update API
   

一键简化方案 #

为了避免重复敲命令，可在主仓库根目录创建一个shell脚本（比如reset-api-submodule.sh）：

#!/bin/bash
# 重置API子模块至当前分支绑定的远程仓库
git submodule deinit -f API && git submodule init API && git submodule update API

添加执行权限：

chmod +x reset-api-submodule.sh

后续切换分支后直接运行./reset-api-submodule.sh即可，完全不用修改现有脚本的目录路径。

前置要求 #

确保主仓库各分支的.gitmodules文件中，API子模块的url字段已正确配置：

• 旧分支：url = <API_V1仓库地址>
• develop分支：url = <API_V2仓库地址>

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