Git子模块引用显示提交哈希而非当前分支的技术疑问

我来帮你理清这个子模块显示的问题～先从你给出的子模块状态输出说起：

+a3ebd2c9635f67ef7d0b430e505e40fa65f3abd4 android-libs-core (0.3-145-ga3ebd2c)
6041beecf8082b2e68b597e3305c8b9ef4012772 android-libs-debug (heads/master)
df7dad74c8b922714b2f17defb8172df7ecf32ea android-libs-router (v1.1-5-gdf7dad7)
7a669bac24430841a5d86c0d90964cd612005769 android_libs_view (heads/master)

为什么有的子模块显示分支，有的只显示哈希？ #

git submodule status的输出逻辑是这样的：

• 如果子模块本地当前HEAD正指向某个分支的最新提交（未处于分离头指针状态），就会显示heads/分支名，比如你的android-libs-debug和android_libs_view。
• 如果子模块处于分离头指针状态（比如直接checkout了某个具体哈希、标签，或者父仓库拉取的子模块哈希和子模块本地分支不一致），Git就会用最近标签-提交计数-g+短哈希的格式来描述，比如android-libs-core和android-libs-router。

关于你“明明追踪master却不显示分支”的疑问 #

这里要区分两个核心概念：

• 子模块的追踪分支：这是在.gitmodules文件里配置的（比如branch = master），它决定了git submodule update --remote时会拉取哪个远程分支的代码，和子模块本地当前的HEAD状态无关。
• 子模块本地的HEAD状态：即使配置了追踪master，如果你在子模块里checkout了某个特定哈希（比如父仓库记录的旧版本），或者拉取父仓库后子模块自动checkout到了指定哈希，子模块就会进入分离头指针状态，这时git submodule status就不会显示分支名了。

解决办法：让子模块回到分支并显示分支名 #

1. 进入子模块目录，切换到目标分支：

cd android-libs-core
git checkout master
cd ..

2. 更新父仓库的子模块引用：
   父仓库需要记录子模块当前分支的最新哈希，这样后续拉取父仓库时，子模块也能保持在分支上：

git add android-libs-core
git commit -m "Update android-libs-core submodule to latest master"

3. 配置子模块默认追踪分支（可选）：
   如果想避免后续再次进入分离头指针状态，可以修改.gitmodules文件，确保子模块配置了追踪分支：

[submodule "android-libs-core"]
    path = android-libs-core
    url = 你的子模块远程仓库地址
    branch = master

然后同步配置并更新子模块：

git submodule sync
git submodule update --remote --checkout

如果只是想快速查看子模块配置的追踪分支，不用修改文件，可以运行：

git config -f .gitmodules submodule.android-libs-core.branch

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