如何实现主仓库分支关联对应子模块分支？解决.gitmodules合并问题

核心问题在于.gitmodules是仓库级共享文件，分支合并时会同步其配置，因此无法通过单一配置实现不同主分支绑定不同子模块分支。我们可以通过分支独立的子模块提交锁存+冲突规避配置来解决：

1. 分别为两个主仓库分支绑定对应子模块分支 #

主仓库的每个分支会单独记录子模块的当前提交哈希，我们只需要在对应主分支中，将子模块切换到目标分支并锁存最新提交：

处理主仓库master分支 #

# 切换到主仓库master分支
git checkout master

# 进入子模块，切换到master分支并拉取最新代码
cd submodule_1
git checkout master
git pull origin master
cd ..

# 提交主仓库中对子模块提交哈希的更新
git add submodule_1
git commit -m "Lock submodule_1 to latest master branch commit"

处理主仓库dev分支 #

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

# 进入子模块，切换到dev分支并拉取最新代码
cd submodule_1
git checkout dev
git pull origin dev
cd ..

# 提交主仓库中对子模块提交哈希的更新
git add submodule_1
git commit -m "Lock submodule_1 to latest dev branch commit"

后续切换主仓库分支时，执行git submodule update --init --recursive，子模块会自动切换到对应分支的锁存版本。

2. 规避.gitmodules分支配置的合并冲突 #

如果你需要在.gitmodules中指定分支（比如用git submodule update --remote拉取），分支合并时会因为branch字段值不同产生冲突。可以通过以下方式解决：

在主仓库根目录创建.gitattributes文件，添加规则让.gitmodules合并时保留当前分支的配置：

.gitmodules merge=ours

将该文件提交到所有主分支，之后合并分支时，当前分支的.gitmodules配置会被保留，不会被其他分支覆盖。

3. 简化操作的小技巧 #

可以在全局~/.gitconfig中添加别名，一键完成分支切换+子模块更新：

[alias]
    sub-master = !git checkout master && git submodule update --init --recursive && cd submodule_1 && git checkout master && git pull && cd ..
    sub-dev = !git checkout dev && git submodule update --init --recursive && cd submodule_1 && git checkout dev && git pull && cd ..

之后只需执行git sub-master或git sub-dev，就能快速切换到对应主分支并同步子模块的目标分支。

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