Git主仓库切换分支时子模块HEAD脱离，求最优标准解决方式

Git 子模块默认仅在主仓库中记录对应绑定的提交哈希，不会关联子模块的分支信息。你之前配置的submodule.subMod_A.update=rebase/merge仅控制子模块更新时和本地修改的合并策略，不会自动将子模块 HEAD 绑定到配置的跟踪分支上，因此切换主分支后默认都是游离头状态。

步骤1：各主分支配置对应子模块跟踪分支 #

分别在两个主分支下编辑.gitmodules文件，明确配置subMod_A对应的跟踪分支，配置完成后提交到对应主分支。

• master分支的.gitmodules配置：

[submodule "subMod_A"]
    path = submodule/subMod_A
    url = <你的subMod_A仓库地址>
    branch = alfa

• hotel分支的.gitmodules配置：

[submodule "subMod_A"]
    path = submodule/subMod_A
    url = <你的subMod_A仓库地址>
    branch = beta

步骤2：配置post-checkout钩子实现自动绑定 #

Git 切换分支完成后会自动触发post-checkout钩子，我们可以在该钩子中添加子模块分支切换逻辑，全程无需手动操作。

1. 进入主仓库的钩子目录，创建/编辑.git/hooks/post-checkout文件，写入以下内容：

#!/bin/bash
# 仅处理分支切换场景，过滤文件级checkout操作
if [ $3 -eq 1 ]; then
    # 更新子模块到当前主分支记录的对应提交
    git submodule update
    # 读取当前主分支配置的子模块跟踪分支
    SUB_BRANCH=$(git config -f .gitmodules submodule.subMod_A.branch)
    # 进入子模块目录切换到对应分支，绑定HEAD
    cd submodule/subMod_A
    git checkout $SUB_BRANCH
    # 返回主仓库根目录
    cd ../../
fi

2. 给钩子文件添加可执行权限：
   chmod +x .git/hooks/post-checkout

效果验证 #

配置完成后执行主分支切换操作即可验证：

• 执行git checkout master，subMod_A自动切换到alfa分支，HEAD处于绑定状态
• 执行git checkout hotel，subMod_A自动切换到beta分支，HEAD处于绑定状态

团队协作同步说明 #

如果是多人协作项目，可将钩子文件放到项目根目录的custom-hooks目录提交到仓库，再添加一个初始化脚本引导成员执行以下命令配置本地钩子路径，保证所有成员都能生效：
git config core.hooksPath custom-hooks

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