Git子模块问题：切换分支时旧分支变更同步至当前分支

问题根源 #

Git子模块的工作区状态是全局的，而非分支专属。当你在分支B1中删除子模块M并提交，只是修改了主仓库的.gitmodules文件和子模块引用记录，但本地工作区里的M目录已经被删除。切换到分支B2时，Git只会同步主仓库的文件（如果B2的.gitmodules里仍包含M的配置），但不会自动恢复工作区中已被删除的子模块目录——因为Git默认不会覆盖工作区的未提交变更，哪怕这些变更来自其他分支。

本质上，B2的仓库记录里子模块M依然存在，只是工作区没有同步到该分支的状态，才会出现“B2里也没有M”的假象。

解决办法 #

• 切换分支前重置工作区：切换分支前，先执行git submodule update --init --recursive确保当前分支的子模块状态正常，再用git reset --hard HEAD重置工作区到当前分支的最新提交状态，彻底清除分支间的残留变更。
• 切换分支后强制同步子模块：切换到目标分支后，立即运行git submodule update --init --recursive，这条命令会根据当前分支的.gitmodules配置，自动拉取对应的子模块版本，恢复缺失的子模块目录。
• 切换分支时直接递归同步：使用git checkout 目标分支名 --recurse-submodules命令切换分支，Git会自动同步目标分支对应的所有子模块状态，避免工作区保留上一个分支的子模块变更。
• 确保分支子模块配置独立：在分支中修改子模块（添加、删除、更新版本）后，务必提交完整的相关变更（包括.gitmodules文件和主仓库中对子模块的引用记录），保证不同分支的子模块配置完全独立，不会互相干扰。

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