如何批量切换存在feature_B分支的Git子模块至该分支？

问题背景 #

假设Git仓库结构如下：

root
|-- .gitmodules
|-- X
    |-- submodule 1
    |-- submodule 2
    ..
    |-- submodule N

我在顶层模块的feature_B分支开发，已为每个子模块手动创建feature_B分支，且所有子模块的变更都推送到了远程。之后我切到顶层模块的master分支做测试，执行了以下命令：

cd $TOPMODULE
git checkout master 
git pull #just to be sure
git submodule update --init --recursive --force

# 执行master分支上的测试操作

但git submodule update命令把所有子模块都重置成了顶层模块指定的提交版本。现在我想把所有存在feature_B分支的子模块切回该分支，除了手动逐个操作，有没有程序化的方法？我自己写了一段bash脚本，但想知道Git有没有原生命令能实现这个需求：

#!/bin/bash
#set -x
#set -e

cd $TOPMODULE

BRANCH_NAME=$1
SUBS=$( cat .gitmodules | grep -Po "(?<=path = )keyword.*" )
git show-ref --verify --quiet refs/heads/${BRANCH_NAME}

for SUBMODULE_PATH in ${SUBS}
do
    cd $SUBMODULE_PATH
    
    if git show-ref --verify --quiet refs/heads/${BRANCH_NAME}; then
        #echo "checkout " $BRANCH_NAME "in" $SUBMODULE_PATH 
        git checkout $BRANCH_NAME
        git pull
    else 
        echo $BRANCH_NAME "does not exist in" $SUBMODULE_PATH  
    fi
    cd - 
done

解决方案 #

1. Git原生命令组合实现 #

Git没有单一命令直接完成批量切换子模块到指定分支的操作，但可以用git submodule foreach命令结合条件判断来实现，无需手动解析子模块路径：

基础切换版本

git submodule foreach 'git checkout feature_B || echo "分支feature_B不存在于当前子模块"'

切换并拉取远程最新代码

如果需要同步远程分支的最新内容，可以扩展为：

git submodule foreach 'if git show-ref --verify --quiet refs/heads/feature_B; then git checkout feature_B && git pull; else echo "分支feature_B不存在于当前子模块"; fi'

git submodule foreach会自动遍历所有已注册的子模块，在每个子模块目录下执行指定命令，比手动解析.gitmodules文件更可靠。如果需要处理嵌套子模块，只需添加--recursive参数即可。

2. 优化你的Bash脚本 #

你的脚本中解析.gitmodules的正则表达式存在小问题（keyword.*应为通用路径匹配，比如改为.*），这里提供一个更健壮的优化版本：

#!/bin/bash
set -euo pipefail

# 自动获取顶层仓库路径，无需依赖环境变量
TOPMODULE=$(git rev-parse --show-toplevel)
# 默认分支为feature_B，也可通过命令行参数指定
BRANCH_NAME=${1:-feature_B}

# 可选：检查顶层仓库是否存在目标分支
if ! git show-ref --verify --quiet refs/heads/"${BRANCH_NAME}"; then
    echo "顶层仓库不存在分支${BRANCH_NAME}"
    exit 1
fi

# 遍历所有子模块（含嵌套子模块可加--recursive）
git submodule foreach '
if git show-ref --verify --quiet refs/heads/"$BRANCH_NAME"; then
    echo "切换子模块$(basename "$PWD")到${BRANCH_NAME}分支..."
    git checkout "$BRANCH_NAME"
    git pull
else
    echo "子模块$(basename "$PWD")不存在${BRANCH_NAME}分支"
fi
' BRANCH_NAME="${BRANCH_NAME}"

优化点说明：

• 用git rev-parse --show-toplevel自动获取顶层仓库路径，避免环境变量依赖
• 添加set -euo pipefail提升脚本的错误处理能力和健壮性
• 利用git submodule foreach传递变量，简化子模块遍历逻辑
• 增加了分支存在性检查和友好的提示信息

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