为何指定.gitmodules分支仍需git submodule update --remote？

一、核心问题：按.gitmodules指定分支更新子模块（避免--remote全局影响） #

git submodule默认的update命令只会拉取主仓库中记录的子模块特定commit，不会理会.gitmodules里的分支配置。--remote参数会让子模块拉取其跟踪分支的最新代码，但如果只想针对部分子模块操作，或者严格遵循.gitmodules的配置，按以下步骤操作：

1. 同步本地配置与.gitmodules
   先确保本地.git/config里的子模块配置和.gitmodules完全一致，避免本地旧配置干扰：

   git submodule sync --recursive
   

2. 单个子模块按配置分支更新
   只更新指定子模块（比如名为my-submodule的子模块），严格遵循.gitmodules里的分支配置：

   git submodule update --init --remote my-submodule
   

   这个命令只会操作目标子模块，不会影响其他子模块，同时会拉取该子模块配置分支的最新代码。

3. 全部子模块按配置分支批量更新
   如果要所有子模块都严格按.gitmodules的分支更新，用foreach遍历执行命令，完全自定义逻辑：

   git submodule foreach '
     BRANCH=$(git config -f $toplevel/.gitmodules submodule.$name.branch)
     git checkout $BRANCH
     git pull origin $BRANCH
   '
   

   这个命令会逐个读取.gitmodules里每个子模块的分支配置，切换到对应分支并拉取最新代码，完全不受全局--remote的潜在影响。

二、修复安装脚本重复配置问题 #

脚本重复执行子模块添加/初始化命令会导致.gitmodules或.git/config出现重复条目，改成幂等逻辑即可：

# 示例：检查子模块是否已存在，不存在才添加
SUBMODULE_PATH="my-submodule"
if [ ! -d "$SUBMODULE_PATH/.git" ]; then
  git submodule add <子模块仓库URL> "$SUBMODULE_PATH"
fi

# 同步配置并初始化更新
git submodule sync --recursive
git submodule update --init "$SUBMODULE_PATH"

这样每次执行脚本时，只会在子模块未初始化的情况下才执行添加操作，避免重复配置。

三、修复git submodule status与配置不符的问题 #

git submodule status显示的是子模块当前的commit、路径及状态（是否偏离主仓库记录的commit），出现不一致通常是因为子模块未在配置分支上，或主仓库记录的commit不是分支最新版本：

1. 按前文步骤同步配置并将所有子模块切换到配置分支，拉取最新代码；
2. 回到主仓库，提交子模块的最新commit记录：

   git add my-submodule
   git commit -m "Update submodule to latest commit on configured branch"
   

3. 再次执行git submodule status，此时显示的状态就会和.gitmodules的配置匹配，主仓库记录的commit也会是对应分支的最新版本。

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