git同时推送到多个远程仓库【攻略】

能——但很多开发者一开始就把方向搞反了。真正靠谱的做法，不是“多加几个 remote”，而是给同一个 remote 配多个 pushurl，或者直接写个小脚本，逐个推一遍。

先澄清一个很常见的误解。

很多人以为，在本地仓库里用 git remote add gitee ... 再加一个 remote，就能一个 git push 命令同时推到 GitHub 和 Gitee 两个地方。设想很美好，但 Git 的默认行为是：只认 origin。你手动加的第二个、第三个 remote，它不会自动去碰。

这背后有个很直接的逻辑：git remote add 创建的是完全独立的 remote，每个 remote 都有自己的 fetch 和 push 行为。想让 git push 一次覆盖多个地址，就得让 Git “觉得”它们都属于同一个 remote 的推送目标。VSCode 内置的 Git 面板、各种 IDE 插件、CI/CD 脚本，默认都只盯着 origin。所以，加个 gitee 就想一键双推？结果往往是只有 origin 被更新，另一个仓库长期处于脱节状态。

正确配置：用 git remote set-url --add --push 给 origin 追加推送地址

没错，这是 Git 原生就提供的一种“多推送镜像”机制：一个 remote 可以拥有多个 pushurl，但只有一个 url（用来拉取代码）。执行 git push 时，Git 会挨个尝试每个 pushurl，没推成功的不会影响下一个。

• 第一步，确保 origin 已经存在：git remote add origin https://github.com/user/repo.git
• 然后，追加第一个额外的推送地址：git remote set-url --add --push origin https://gitee.com/user/repo.git
• 再追加第二个：git remote set-url --add --push origin https://gitlab.company.com/user/repo.git
• 最后验证一下：运行 git remote -v，你应该能看到一行 (fetch) 和多行 (push)。

配置完成后，执行 git push origin main，Git 就会依次向这三个地址推送代码。

容易踩的坑：权限、分支保护、错误反馈全混在一起

这个方法虽然好用，但有几个细节需要注意。多个 pushurl 是串行执行的，但错误信息会堆在一起。一旦某个远端推送失败，你很难快速定位是哪个远端出了问题。

更麻烦的是，不同平台对推送的限制策略完全不同：

• GitHub 允许 main 分支强制推送，但 GitLab 可能被 pre-receive hook 拦住，Gitee 又可能要求走 PR 流程。
• 某个远端的认证过期了（比如 token 失效），Git 虽然会继续推下一个，但终端输出里只报最后一段错，你根本不知道前面的出了什么问题。
• 如果某次推送因为网络超时而失败，Git 不会自动重试，也不会告诉你哪些远端成功了、哪些没发出去。
• 如果用 git config --add remote.origin.pushurl 手动写进 .git/config 也能生效，但千万注意别漏掉 --add，否则就会直接覆盖掉之前唯一的 pushurl。

更可控的做法：写个 shell 别名或小脚本

比起依赖 Git 内部的多 pushurl 行为，我更倾向于用显式控制的方式，尤其是在需要调试和维护的场景下。这种做法更清晰，也更好排查问题。

• 可以定义一个 Git 别名：git config --global alias.pushall '!f() { git push github "$1" && git push gitee "$1" && git push gitlab "$1"; }; f'
• 用法很简单：git pushall main —— 任何一个远端推送失败，脚本都会立即终止，出错位置一目了然。
• 或者手写一个 git-push-multiple 脚本，放在 $PATH 里。脚本里对每个 remote 单独执行 git push ，并捕获 $? 来判断成功与否。

在 CI/CD 场景下，强烈建议用脚本方式。你可以给脚本加上日志、重试、告警功能，还能根据环境跳过某些不可达的远端（比如内网 GitLab 在 GitHub Actions 里根本连不通）。

说到底，多仓库同步这件事，最难的不是怎么加上地址，而是各个远端在权限策略、分支规则、hook 逻辑、网络可达性上的差异。这些细节一旦考虑不周，所谓的“同步”就会变成“看起来推了，其实只到一半”。