如何让Git主仓库ProjectA使用子模块ProjectB的自定义分支？

本地临时切换（仅自身环境生效） #

如果只是自己本地需要让ProjectA的子模块用上修复好的FeatureBranch，直接切换子模块分支即可：

• 进入ProjectA下的ProjectB子模块目录：

  cd ProjectA/ProjectB
  

• 切换到目标分支：

  git checkout FeatureBranch
  

• 回到主仓库根目录验证状态：

  cd ..
  git status
  

  此时会看到ProjectB子模块显示“modified content”，这是正常状态，因为子模块的HEAD已指向FeatureBranch的最新提交。

持久化配置（团队共享生效） #

如果需要让其他克隆ProjectA的人也自动使用FeatureBranch分支，需修改子模块跟踪配置并提交主仓库变更：

1. 编辑.gitmodules文件
   回到ProjectA根目录，打开.gitmodules文件，找到ProjectB对应的配置块，添加或修改branch字段为FeatureBranch：

   [submodule "ProjectB"]
       path = ProjectB
       url = 你的ProjectB仓库地址
       branch = FeatureBranch
   

2. 同步子模块配置
   执行命令让子模块同步新的分支配置：

   git submodule sync
   

3. 拉取子模块分支最新代码
   更新子模块到FeatureBranch的最新状态：

   git submodule update --remote
   

4. 提交主仓库变更
   将修改后的.gitmodules文件和子模块状态变更提交到ProjectA仓库：

   git add .gitmodules ProjectB
   git commit -m "Update submodule ProjectB to track FeatureBranch"
   

后续其他人克隆ProjectA时，执行git clone --recurse-submodules ProjectA.git会自动拉取ProjectB的FeatureBranch分支代码；已克隆的仓库执行git submodule update --init --remote即可切换到该分支。

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