为何git submodule status与子模块内git branch输出不一致？

问题描述 #

执行git submodule update --init --recursive --remote meta-dataset后，用git submodule status查看，显示meta-dataset子模块处于commit ca81edbf5093ec5ea1a1f5a4b31ec4078825f44b（标注为arxiv_v1-200-gca81edb），但进入子模块执行git branch，当前分支却是hdb。多次重新执行git submodule init、git submodule update --init --recursive --remote，甚至手动在子模块内git checkout hdb切换分支，git submodule status的输出始终和子模块实际分支状态不匹配。使用的Git版本为2.37.0 (Apple Git-136)。

用户操作日志：

(meta_learning) brandomiranda~/ultimate-utils/tutorials_for_myself/my_git ❯ git submodule update --init --recursive --remote meta-dataset
(meta_learning) brandomiranda~/ultimate-utils/tutorials_for_myself/my_git ❯ git submodule status                                          
 ca81edbf5093ec5ea1a1f5a4b31ec4078825f44b meta-dataset (arxiv_v1-200-gca81edb)

(meta_learning) brandomiranda~/ultimate-utils/tutorials_for_myself/my_git/meta-dataset ❯ git branch
* hdb

原因与解决方法 #

核心原因 #

Git子模块的本质是父仓库中存储的是子模块的固定commit哈希，而非分支引用。git submodule status显示的是父仓库当前记录的子模块commit，和子模块本地切换到哪个分支没有直接关系——哪怕你在子模块里切到其他分支，只要父仓库没更新子模块的commit记录，git submodule status就不会变。

解决步骤 #

1. 让父仓库记录子模块当前分支的最新commit

如果要让git submodule status显示hdb分支的最新状态，需要手动更新父仓库的子模块引用：

• 进入子模块目录：cd meta-dataset
• 拉取hdb分支的最新代码：git pull origin hdb
• 回到父仓库：cd ..
• 此时再执行git submodule status，就能看到子模块的commit已经更新为hdb分支的最新版本
• 最后提交这个更新到父仓库：git add meta-dataset，然后git commit -m "更新meta-dataset子模块到hdb分支最新commit"

2. 配置默认跟踪目标分支（可选）

如果希望后续执行git submodule update --remote时，自动拉取hdb分支的最新代码，需要修改父仓库的.gitmodules文件：
找到meta-dataset对应的配置块，添加或修改branch = hdb：

[submodule "meta-dataset"]
  path = meta-dataset
  url = <你的子模块远程仓库地址>
  branch = hdb

保存文件后，执行git submodule update --remote，父仓库就会自动拉取hdb分支的最新commit，并更新自身的子模块记录。

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