Git子模块切换分支出现异常问题求助

核心原理 #

Git子模块默认绑定固定提交哈希，而非动态追踪分支。当初始化时用-b参数仅设置了子模块的branch配置项，但主仓库依然只记录子模块的某个具体提交。要切换并让主仓库稳定追踪新分支，需要同步配置并更新主仓库的记录。

正确操作步骤 #

假设主仓库已初始化，子模块libs/esp-aws-iot初始关联release/v3.1.x分支，现在要切换到master分支：

1. 进入子模块，切换目标分支并同步远程代码 #

cd libs/esp-aws-iot
git checkout master
git pull origin master  # 确保本地分支与远程最新代码同步
cd ../..

2. 更新主仓库的子模块分支追踪配置（可选，但推荐） #

如果希望后续用git submodule update --remote能自动拉取master分支的最新代码，需要修改.gitmodules里的分支配置：

git config -f .gitmodules submodule.libs/esp-aws-iot.branch master
git add .gitmodules  # 将配置变更提交到主仓库

3. 提交主仓库中子模块的新哈希记录 #

此时主仓库会检测到子模块的提交哈希发生变化，需要提交这个变更来固化新状态：

git add libs/esp-aws-iot
git commit -m "Update submodule esp-aws-iot to master branch latest commit"

你的操作问题分析 #

1. git submodule update --remote切回原分支的原因
   初始添加子模块时-b release/v3.1.x把.gitmodules里的branch项设为了release/v3.1.x，git submodule update --remote会默认拉取该配置分支的代码，所以会自动切回原分支。必须修改.gitmodules里的分支配置，才能让--remote指向新分支。

2. 子模块出现未追踪文件aws-iot-device-sdk-embedded-C的原因
   这是子模块本身的嵌套子模块，切换分支后新分支的嵌套子模块配置与原分支不一致，导致出现未追踪状态。正确做法是切换子模块分支后，重新初始化嵌套子模块：

   cd libs/esp-aws-iot
   git submodule update --init --recursive
   

   而非把嵌套子模块当作普通文件提交，这会导致子模块本地状态与远程不一致，出现"超前1个提交"的错误。

3. 主仓库显示子模块有修改的原因
   主仓库记录的是子模块的具体提交哈希，切换子模块分支后哈希值变化，主仓库会识别为子模块内容修改，必须提交这个哈希变更才能让主仓库记录新的子模块状态。

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