带子模块的Git分支管理：批量切换dev/main分支的方案问询

核心解决方案：利用git submodule foreach批量操作 #

Git的submodule foreach命令可以遍历所有子模块并执行指定Git命令，完全不需要修改.gitmodules配置就能实现批量分支切换与更新，完美匹配你的需求。

步骤1：切换主仓库到dev并批量更新子模块到dev分支 #

当需要在dev环境协同测试时，执行以下命令：

# 切换主仓库repo1到dev分支
git checkout dev

# 遍历所有子模块，切换到dev分支并拉取最新代码
git submodule foreach 'git checkout dev && git pull'

步骤2：测试完成后，批量合并子模块dev到main分支 #

确认测试通过后，批量合并各子模块的开发分支到主分支：

# 遍历所有子模块，切换到main分支，合并dev分支并推送到远程
git submodule foreach 'git checkout main && git merge dev && git push'

注意：如果合并时出现冲突，需要进入对应的子模块目录手动解决冲突，完成后重新执行上述命令即可。

步骤3：更新主仓库main分支并推送最终状态 #

子模块合并完成后，更新主仓库的子模块引用并推送：

# 切换主仓库repo1到main分支
git checkout main

# 遍历所有子模块，切换到main分支并拉取最新合并后的代码
git submodule foreach 'git checkout main && git pull'

# 提交主仓库中子模块的引用更新
git add .
git commit -m "Update submodules to main branch after dev merge"
git push

更优实践：编写自动化脚本简化操作 #

为避免重复输入命令，可编写两个Shell脚本一键完成流程：

脚本1：切换到dev环境（switch-to-dev.sh） #

#!/bin/bash
set -e # 遇到错误时终止脚本

echo "Switching repo1 to dev branch..."
git checkout dev

echo "Updating all submodules to dev branch..."
git submodule foreach 'git checkout dev && git pull'

echo "✅ Successfully switched to dev environment!"

脚本2：合并dev到main并更新主仓库（merge-dev-to-main.sh） #

#!/bin/bash
set -e

echo "Merging dev to main in all submodules..."
git submodule foreach 'git checkout main && git merge dev && git push'

echo "Switching repo1 to main branch..."
git checkout main

echo "Updating all submodules to main branch..."
git submodule foreach 'git checkout main && git pull'

echo "Committing submodule updates to repo1..."
git add .
git commit -m "Update submodules to main branch post dev merge"
git push

echo "✅ Successfully merged dev to main and updated repo1!"

使用脚本 #

给脚本添加执行权限后即可运行：

chmod +x switch-to-dev.sh merge-dev-to-main.sh

# 切换到dev环境
./switch-to-dev.sh

# 合并dev到main并更新
./merge-dev-to-main.sh

注意事项 #

• 执行所有命令前，确保主仓库和所有子模块都没有未提交的本地修改，避免操作失败。
• 如果子模块的dev分支不存在，需要先在对应子模块中创建并推送到远程。
• 合并冲突需要手动处理，处理完成后重新执行对应命令即可。

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