Git配置双远程仓库（GitHub+Overleaf）同步拉取推送及分支问题

一、解决分支不匹配的推送问题 #

你之前共用origin远程并添加多个push URL的方式，会因分支名不一致（GitHub用main，Overleaf用master）导致推送失败。建议分开配置两个独立远程，再设置分支推送映射：

1. 重新添加独立远程（替换原有共用origin的配置）

   # 移除原有origin中Overleaf的push地址（若之前origin默认关联GitHub）
   git remote set-url --delete origin git@latex.hu-berlin.de/git/…
   # 添加GitHub为独立远程
   git remote add github https://github.com/…
   # 添加Overleaf为独立远程
   git remote add overleaf git@latex.hu-berlin.de/git/…
   

2. 配置本地main分支的推送规则
   让本地main分支推送到GitHub的main分支，同时推送到Overleaf的master分支：

   # 关联本地main分支到GitHub的main分支
   git branch -u github/main main
   # 设置推送到Overleaf时将main映射为master
   git config remote.overleaf.push refs/heads/main:refs/heads/master
   

3. 一键推送两个远程
   在本地.git/config中添加别名，实现一键推送：

   [alias]
       pushboth = !git push github && git push overleaf
   

   之后只需执行git pushboth即可同时推送到两处。

二、实现GUI一键拉取两个远程代码 #

Git本地分支只能跟踪一个远程分支，但可以通过git别名实现一键拉取两个远程的代码，再在GUI中调用该别名：

1. 添加拉取别名
   在.git/config中添加：

   [alias]
       pullboth = !git pull github main && git pull overleaf master
   

   该命令会先拉取GitHub的main分支，再拉取Overleaf的master分支，拉取后若有冲突需手动解决。

2. 在GUI中调用别名

   • VS Code：打开命令面板（Ctrl+Shift+P），输入Git: Run Command，选择pullboth即可一键拉取。
   • GitHub Desktop：暂不支持直接调用自定义git别名，可通过「Repository」→「Open in Terminal」执行git pullboth，或自定义脚本绑定到快捷键。

内容的提问来源于stack exchange，提问作者Stefan Müller