Git主仓库操作时子模块自动切换为HEAD状态如何解决？

要让Git在主仓库切换分支、拉取变更等操作时，始终保持子模块在指定分支，你可以通过以下几步实现：

1. 为子模块设置跟踪分支 #

首先确保每个子模块都明确跟踪目标分支，这会修改仓库的.gitmodules配置文件，让Git知晓子模块的默认分支：

# 替换main为你的子模块目标分支，submod1为子模块名称
git submodule set-branch --branch main submod1
git submodule set-branch --branch main submod2

执行后，.gitmodules中对应子模块的条目会新增branch = main字段，明确子模块的跟踪分支。

2. 禁止主仓库操作时自动重置子模块 #

Git默认会在主仓库切换分支、拉取时，将子模块重置到主仓库记录的commit版本。你可以通过配置关闭这个行为：

全局/主仓库级禁用自动更新 #

针对当前主仓库，设置子模块不自动更新：

git config submodule.recurse false

这个配置会让Git在主仓库执行任何操作时，都不会主动修改子模块的状态。

针对单个子模块禁用自动更新 #

如果需要更精细的控制，只针对特定子模块关闭自动重置：

git config submodule.submod1.update none
git config submodule.submod2.update none

3. 快速恢复子模块到指定分支（应急用） #

如果不小心触发了子模块的重置，可通过以下命令快速将所有子模块切回指定分支：

git submodule foreach git checkout main

你也可以给这个操作设置Git别名简化操作：

git config alias.subcheckout 'submodule foreach git checkout main'

之后只需执行git subcheckout就能一键恢复所有子模块到目标分支。

注意事项 #

• 确保.gitmodules文件被提交到主仓库，这样其他克隆仓库的开发者也能继承相同的子模块配置。
• 如果主仓库不同分支对应子模块的目标分支不同，这种方法可能不适用，需要提前统一分支策略或在切换分支后手动调整子模块分支。

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