执行git commit后为何进入detached HEAD状态？

核心原因 #

你的问题本质是子模块的分支跟踪机制和操作目录混淆导致的，具体分三点：

• 操作目录混淆
  你执行git status得到的On branch master是主仓库的分支状态，但执行git commit时实际是在子仓库目录下操作。此时子仓库虽然通过--merge合并了远程更新，但并未处于正式的本地分支上（或之前处于分离头状态），提交后自然生成分离头指针的提交。

• --merge参数的局限性
  git submodule update --remote --merge只会把子仓库远程跟踪分支的更新合并到当前HEAD指向的位置，不会自动将子仓库切换到本地分支。如果执行命令前子仓库处于分离头状态，合并后依然是分离头状态，只是git状态提示可能显示类似On branch master的信息（因为合并了origin/master），但本质还是分离头，提交时就会出现对应的提示。

• 主仓库仅跟踪子仓库的特定提交
  主仓库默认只存储子仓库的具体提交哈希，而非分支引用。即使子仓库处于本地分支，主仓库也不会关联这个分支状态。当你在子仓库提交新内容后，子仓库HEAD与主仓库记录的哈希不一致，从主仓库视角看子仓库处于分离头状态，而你在子仓库内提交时，就会直接在分离头下生成新提交。

解决办法 #

• 确认操作目录：执行pwd明确当前是主仓库还是子仓库。如果是子仓库，先执行git checkout master切换到正式分支再提交。
• 配置子模块跟踪分支：在主仓库执行git submodule set-branch --branch master <子模块路径>，让主仓库跟踪子仓库的master分支，后续git submodule update --remote会自动切换到该分支并更新。
• 同步主仓库记录：子仓库提交完成后，回到主仓库，执行git add <子模块路径>，然后在主仓库的master分支提交，此时主仓库会记录子仓库的最新提交哈希。

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