执行不同Git子模块拉取命令为何结果不同？

git pull --recurse-submodules的核心逻辑是同步主仓库记录的子模块版本：它先拉取主仓库的最新代码，然后根据主仓库中存储的子模块固定提交哈希，将子模块切换到该哈希对应的旧版本。这个命令的设计目的是让子模块与主仓库当前快照保持完全一致，不会主动去子模块的远程仓库拉取最新提交。

而git submodule update --recursive --remote的作用是主动拉取子模块远程仓库的最新代码：它会直接访问子模块的远程源，拉取对应分支的最新提交，同时更新主仓库中记录的子模块哈希值。这两个命令的定位完全不同，前者是“对齐主仓库快照”，后者是“主动升级子模块”。

要让git pull --recurse-submodules能拉取到子模块的最新版本，有两种常用方案：

方案1：组合命令+Git别名 #

直接在git pull --recurse-submodules后追加子模块更新命令，一步到位可以通过Git别名简化：

git config --global alias.pull-sub '!git pull --recurse-submodules && git submodule update --recursive --remote'

之后只需执行git pull-sub，就能同步主仓库并将子模块升级到远程最新版本。

方案2：配置子模块跟踪远程分支 #

默认子模块处于游离HEAD状态，仅跟踪主仓库记录的哈希。设置子模块跟踪特定远程分支后，git pull --recurse-submodules会自动拉取该分支的最新代码：

1. 进入子模块目录：cd path/to/your/submodule
2. 切换到要跟踪的分支（比如main）：git checkout main
3. 返回主仓库，配置子模块跟踪该分支：git config -f .gitmodules submodule.<你的子模块名称>.branch main
4. 提交配置修改：git add .gitmodules && git commit -m "配置子模块跟踪main分支"

完成配置后，执行git pull --recurse-submodules时，子模块会自动拉取对应远程分支的最新提交，同时更新主仓库中记录的子模块哈希。

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