git push -u origin branch 是最常用入口，首次推送时一步完成推送和设置上游；git branch --set-upstream-to 仅修改跟踪关系，适用于远程分支已存在但本地未绑定或需更换上游的场景。
本地分支没设上游，git pull 和 git push 就必须每次写全 origin/main 这类参数——这不是懒，是 Git 默认不帮你记这个映射关系。
为什么 git push -u 是最常用入口
新分支首次推送时，git push -u origin feature/login 一步完成两件事：把本地分支推到远程，同时让 Git 记住「这个本地分支以后默认对应 origin/feature/login」。
- 后续
git push或git pull不加参数就能直接走对路 -
-u只在第一次推送时需要，重复执行会报错「already exists」 - 如果远程分支名和本地名不同（比如本地叫
dev，想推到origin/develop），得写全：git push -u origin dev:develop - 别用
git push --set-upstream—— 它是-u的长写法，但容易手误多打空格或等号，出错率更高
git branch --set-upstream-to 适合什么场景
这个命令不推代码，只改关联。适用于：已存在远程分支、但本地分支还没绑定，或者要换上游。
- 给当前分支换上游：
git branch --set-upstream-to=origin/main - 给其他分支设上游（不用先 checkout）：
git branch --set-upstream-to=origin/staging staging - 如果远程分支不存在，命令能成功执行，但后续
git pull会报fatal: Couldn't find remote ref—— 所以设之前先git fetch确认远程有那个分支 - 注意：旧版 Git（--set-upstream（少一个
-to），现在已弃用，用了会警告
怎么确认上游设成功了
别靠猜，用 git branch -vv 看真实状态。
- 输出里带方括号的才是已设上游的分支，比如：
main [origin/main] commit msg - 如果显示
main [no upstream]，说明没设，或者设错了远程名（比如写成upstream/main但远程实际叫origin） -
git status也会提示，比如「Your branch is behind 'origin/main' by 2 commits」—— 这个「behind」的前提就是上游已正确关联 - 如果
git branch -vv没显示任何远程信息，先检查git remote -v是否真有origin，再确认远程仓库 URL 没拼错
解除或修正上游关联的实操要点
上游设错或团队规范变了，得手动清理，不能靠删远程分支来“重置”。
- 解除当前分支上游：
git branch --unset-upstream - 解除指定分支上游：
git branch --unset-upstream feature/foo - 修正远程名错误（比如把
origin错设成upstream）：先--unset-upstream，再用--set-upstream-to重设 - 别直接改
.git/config里的branch.xxx.merge和branch.xxx.remote—— 手动改容易漏项或格式错，Git 自己维护更稳
上游设置看着简单，但真正卡住人的往往是远程名不一致、fetch 没做全、或者以为设了就万事大吉——其实 git branch -vv 才是唯一可信的验证动作。只要这行输出里有方括号，后续所有 pull/push 才算真正省心。
