本地分支与远程分支名不同时git push报错的相关疑问

背景回顾 #

本地分支foo已配置跟踪远程分支PROJ-123-foo（.git/config中merge字段指向该远程分支），但执行git push时收到错误，提示上游分支与本地分支名不匹配，需要指定推送目标。

1. 是否本地分支与远程分支并非始终牢固关联，导致git push无法明确操作？ #

是的。Git里的跟踪关联（merge配置）和推送关联是两个独立概念：

• merge字段仅决定git pull时默认拉取的远程分支
• git push的默认行为由push.default配置控制，和merge配置不一定绑定。若push.default不是upstream这类明确指向跟踪分支的选项，Git会因分支名不匹配无法确定推送目标。

2. 是否本地分支与远程分支的推送关联未正确设置？ #

你的配置仅设置了拉取时的跟踪分支（merge字段），未明确配置推送关联。Git默认不会自动将merge的关联直接作为推送目标，尤其当分支名不一致时。你可以通过以下命令确认推送关联：

git config branch.foo.push

若无输出，说明确实未设置推送关联。

3. 是否应将push.default设置为upstream，该选项是否适合我的场景？ #

完全适合。push.default = upstream的行为是：执行git push时，默认推送到当前分支的上游跟踪分支（即你配置的PROJ-123-foo）。刚好匹配你本地与远程分支名不同的场景，设置后直接git push即可正确推送到目标远程分支，无需每次手动指定。

4. 若push.default = upstream是合适选择，为何它不是默认配置？ #

Git默认配置兼顾兼容性与新手友好性：

• 早期Git默认push.default为matching（推送所有本地与远程同名分支），后来改为simple
• simple是当前默认，它要求本地与远程分支名称完全一致才允许直接git push，目的是避免新手误推至错误分支。而upstream允许分支名不同，但需要用户明确设置过跟踪分支，对新手门槛稍高，因此未成为默认。

5. 除查看配置文件外，是否有更优方式确认或设置远程分支关联？ #

有几个常用命令：

• 确认跟踪关联：执行git branch -vv，会列出所有本地分支及对应远程跟踪分支信息，示例：

  foo    abc1234 [origin/PROJ-123-foo] 最新提交信息
  

• 设置跟踪关联（同时绑定拉取与推送）：新建分支后关联远程，可使用：

  git branch -u origin/PROJ-123-foo foo
  

  或推送时直接设置：

  git push -u origin PROJ-123-foo
  

  这两个命令会同时设置merge和push关联，之后git push和git pull可直接使用。
• 单独设置推送关联：若仅需修改推送目标，使用：

  git config branch.foo.push refs/heads/PROJ-123-foo
  

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