git 默认不自动追踪远程分支，必须显式设置 upstream；否则 git push 和 git pull 会报错。原因在于单纯 git checkout -b dev 不提供来源依据，即使 git 2.0+ 启用 checkout.defaultremote，也仅对 git checkout -b foo origin/foo 等显式带远程 ref 的操作生效。
Git 默认不自动追踪远程分支，必须显式设置 upstream；否则 git push 和 git pull 会报错或行为异常。
为什么 git checkout 新建本地分支后不自动关联远程分支
Git 2.0+ 默认启用 checkout.defaultRemote，但仅影响 git checkout -b foo origin/foo 这类带远程 ref 的显式操作。单纯 git checkout -b dev 或 git switch -c dev 不触发追踪——它只是新建分支，没有来源依据。
常见错误现象：git push 提示 “fatal: The current branch dev has no upstream branch”，或 git pull 报 “There is no tracking information for the current branch”。
- 解决方式一（推荐）：创建时直接指定上游：
git checkout -b dev origin/dev（前提是远程已有dev分支） - 解决方式二：创建后手动设置：
git branch --set-upstream-to=origin/dev dev - 注意：Git 2.37+ 推荐用
git branch -u origin/dev替代冗长写法
git push -u 的真实作用和适用场景
-u（即 --set-upstream）不是“首次推送才需要”，而是“为当前分支绑定默认推送目标”。它只在第一次执行时生效，后续 git push 可省略参数。
使用场景：
- 你刚基于本地修改新建了分支（如
git switch -c feat/login），准备推送到远程同名分支 - 你想把本地分支推到不同名的远程分支（如
git push -u origin feat/login:feature-auth） - 执行后，Git 会在
.git/config中写入merge = refs/heads/dev和remote = origin
⚠️ 容易踩的坑：git push -u origin main 会把当前分支推到远程 main，并设其为 upstream——这很可能不是你想要的，务必核对分支名是否匹配。
自动化工作流中如何避免手动设 upstream
高频协作场景下，靠人记命令容易出错。可借助 Git 配置或脚本固化行为：
- 全局开启自动跟踪（谨慎）：
git config --global push.default upstream，这样git push默认推送到已设置的 upstream，但不会自动创建 upstream - 更实用的是配置别名：
git config --global alias.cob 'checkout -b'，再配合脚本封装常用模式（如git cob dev origin/dev） - CI/CD 流水线中，建议显式使用
git checkout -b $BRANCH_NAME origin/$BRANCH_NAME，避免依赖本地配置差异
性能影响几乎为零，但兼容性要注意：旧版 Git（switch 和简写 -u，团队统一 Git 版本能减少歧义。
远程分支删除后本地 upstream 仍残留怎么办
远程分支被 git push origin --delete dev 删除后，本地分支的 upstream 设置不会自动清除，导致 git status 显示 “behind ‘origin/dev’” 或 git pull 报错。
检查方式：git rev-parse --abbrev-ref --symbolic-full-name @{u}（返回 origin/dev 即存在 upstream）
- 清理单个分支：
git branch --unset-upstream dev - 批量清理失效 upstream：
git remote prune origin && git branch -vv | grep ': gone]' | awk '{print $1}' | xargs -r git branch --unset-upstream - 也可直接编辑
.git/config，删掉对应分支 section 下的merge和remote行
这个残留问题在长期维护的仓库里极常见，尤其多人共用同一 fork 时——上游删了分支，下游却还在尝试同步一个不存在的 ref。
