如何在Git父仓库A的所有分支与提交中更新子模块B的URL

首先明确：Git的历史提交是不可变的，要修改所有历史提交里的.gitmodules内容，本质是重写仓库A的整个提交历史。这种操作存在风险，若仓库已共享给其他协作者，必须提前同步团队配合。

步骤1：准备完整镜像仓库 #

先克隆仓库A的完整本地镜像，确保包含所有分支、标签：

git clone --mirror <仓库A的远程URL> repoA-mirror
cd repoA-mirror

步骤2：用git filter-repo批量替换历史中的旧URL #

git filter-repo是Git官方推荐的历史修改工具（比旧的filter-branch更稳定可靠，新版Git通常自带）。执行命令替换.gitmodules里的旧子模块URL：

git filter-repo --replace-text <(echo '旧的项目BURL=新的项目BURL')

将命令里的旧的项目BURL和新的项目BURL替换为实际地址，该命令会遍历所有提交，自动修改所有.gitmodules文件中的对应URL。

步骤3：处理所有分支 #

由于使用--mirror克隆包含了仓库所有分支，git filter-repo会自动完成所有分支的历史修改，无需单独处理每个分支。

步骤4：强制推送重写后的历史（风险提示） #

若需要同步到远程仓库，执行强制推送覆盖原有历史：

git push --force

⚠️ 关键提醒：强制推送会完全覆盖远程仓库的历史记录，所有协作者必须重新克隆仓库，否则会出现严重的历史冲突。务必提前通知团队成员做好准备。

替代方案（规避历史重写风险） #

如果重写历史的风险过高，可选择以下折中方案：

• 仅更新当前分支及未来提交的URL：使用git submodule set-url <子模块路径> <新URL>，再执行git submodule sync同步配置。
• 在仓库根目录添加说明文档，告知使用旧分支的用户手动执行上述命令更新子模块URL。

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