分支上游跟踪是什么
上游跟踪关系是本地分支与远端分支之间的绑定：绑定后 git status 会直接告诉你领先或落后多少个提交，git pull 与 git push 也能省略远端和分支名。用 --set-upstream-to（-u）建立，用 -vv 查看，用 --unset-upstream 取消。理解这层关系是判断「该先推还是先拉」的基础，避免把改动推到不该动的分支。
基本信息
| 设置 | git branch -u origin/<分支> |
|---|---|
| 查看 | git branch -vv 显示上游与领先落后 |
| 取消 | git branch --unset-upstream |
| 自动设置 | push.default 与 push.autoSetupRemote 可省去手动绑定 |
| 平台 | 任意 Git 客户端 |
典型使用场景
- 新检出分支后确认它绑定到了哪个远端分支
- 判断本地领先远端多少提交，决定推送时机
- 改用不同的远端或分支名后重新绑定上游
- 给拆出来的本地分支指定正确的推送目标
- 取消旧的绑定，避免误推到一个已经废弃的远端分支
- 排查 push 报错时确认跟踪关系是否指向了错误位置
- 多人共用同一分支时，核对本地上游是否指向团队约定的远端
常用示例
常用示例
git branch -vv # 查看上游与领先落后
git branch --set-upstream-to=origin/main main
git branch -u origin/feature-x # 为当前分支绑定上游
git rev-list --left-right --count main...origin/main # 精确计数
git branch --unset-upstream # 取消绑定branch -vv 输出怎么读
| 片段 | 含义 |
|---|---|
| [origin/main] | 当前分支的上游是 origin/main |
| ahead 2 | 本地比远端多两条提交，待推送 |
| behind 3 | 远端比本地多三条，待拉取 |
| 没有方括号 | 该分支尚未绑定上游 |
领先落后数是决定「先推还是先拉」的快速依据：既有 ahead 又有 behind 说明双方分叉，需要先决定合并还是变基再同步。
较新版本可开启 push.autoSetupRemote，首次推送分支时自动建立上游；团队统一开启后，新人漏加 -u 导致的推错问题会明显减少。
核对上游的固定动作
- 推送前 git branch -vv 看目标分支与领先落后
- 远端分支被删除后及时重新绑定，别继续往旧上游推
- 用短命令 git rev-parse --abbrev-ref @{upstream} 直接打印上游名
- 新人环境统一开启自动建立上游，减少手工绑定遗漏