在Git中更新远程子模块前，是否需要先切换到分支？

问题场景 #

我有一个名为“MP”的主项目，依赖虚构子模块仓库“SM”，两者都只有main分支。

初始关联流程 #

通过以下命令完成主仓库与子模块的绑定：

git submodule add URL
git commit -am "Add submodule SM"
git push origin main

此时子模块本地目录的提交日志显示正常，HEAD指向main分支：

059140e (HEAD -> main, origin/main, origin/HEAD) Commit 3
eaebed2 Commit2
81e7318 Initial commit

克隆后的异常状态 #

在新目录克隆主仓库并初始化子模块后：

git clone URL  # 克隆主仓库MP
git remote update --init --recursive  # 初始化、拉取并检出所有子模块及嵌套子模块

子模块的提交日志显示处于分离头指针状态，HEAD未关联main分支：

12a51e4 (HEAD, origin/main, origin/HEAD, main) Commit 3
d190a20 Commit 2
f1311ed Initial commit

核心疑问 #

当子模块有新提交时，我需要更新主项目中子模块的引用至最新提交，是否需要先在子模块目录执行git checkout main，再执行git submodule update --remote？

解答 #

不需要提前执行git checkout main，直接使用git submodule update --remote即可完成子模块更新并同步主项目的引用，但要根据需求选择参数：

• 基础更新方式
  直接运行git submodule update --remote，Git会拉取子模块远程main分支的最新提交，然后将子模块切换到该提交——此时子模块依然会处于分离头指针状态，这是正常行为：因为主项目是通过特定提交哈希来追踪子模块版本的，而非分支引用。

• 保持子模块在分支上操作
  如果你需要在子模块本地做修改并提交到远程分支，可以加上--rebase或--merge参数，让子模块保持在main分支上：

  git submodule update --remote --rebase
  # 或者
  git submodule update --remote --merge
  

  执行后子模块的HEAD会重新指向main分支，而非处于分离状态。

• 同步主项目的子模块引用
  无论用哪种方式更新子模块后，都需要回到主项目根目录，提交子模块的哈希变更，这样其他克隆主项目的人才能同步到最新的子模块版本：

  cd ../  # 回到主项目MP根目录
  git commit -am "Update submodule SM to latest commit"
  git push origin main
  

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