如何更新Git子模块远程仓库？确保团队同步的正确方法

1. 替换子模块远程仓库URL（永久生效） #

当没有原仓库写入权限、需改用fork仓库时，不能仅修改.gitmodules文件，必须同步子模块本地的远程配置：

• 修改项目根目录的.gitmodules文件，将对应子模块的url字段替换为你的fork仓库地址
• 执行命令让Git同步配置到子模块本地仓库：

  git submodule sync --recursive
  

• 进入子模块目录，验证远程地址已更新：

  cd path/to/submodule
  git remote -v
  

  此时origin应显示你的fork仓库地址

2. 在子模块中开发并推送变更 #

• 进入子模块目录，创建新分支开发（避免直接修改主分支引发冲突）：

  git checkout -b feature/custom-func
  

• 完成开发后，提交并推送到fork仓库：

  git add .
  git commit -m "Add custom submodule features"
  git push origin feature/custom-func
  

  后续可在Git平台（GitHub/GitLab等）将分支合并到fork的主分支

3. 更新主仓库中子模块的提交哈希 #

子模块的变更不会自动同步到主仓库，必须在主仓库中记录子模块的最新提交：

• 返回项目根目录，查看子模块状态：

  git submodule status
  

  子模块最新提交哈希前的+号，表示变更未被主仓库记录
• 将子模块的更新提交到主仓库：

  git add path/to/submodule
  git commit -m "Update submodule to custom feature commit"
  git push origin your-branch
  

4. 团队成员拉取更新的正确步骤 #

团队成员拉取你的分支后，需同步子模块的远程配置与内容：

• 拉取主仓库分支：

  git pull origin your-branch
  

• 同步子模块远程配置：

  git submodule sync --recursive
  

• 更新子模块到主仓库记录的最新提交：

  git submodule update --init --recursive
  

  若子模块已初始化，可简化为：

  git submodule update --recursive
  

常见问题排查 #

• 若子模块仍指向原仓库：检查子模块目录下的.git/config文件，确认remote.origin.url为你的fork地址，手动修正后保存
• 若团队成员拉取不到变更：确保你的fork仓库对团队成员开放访问权限，且主仓库已正确提交子模块的最新哈希

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