答案是执行 git push -u origin HEAD 或 git push -u origin 分支名：该命令一次性完成推送与上游关联，设置 .git/config 中的 remote 和 merge 配置，后续 git push/git pull 可省略参数；若已推送未设上游，用 git branch -u origin/分支名 补设。
git push 第一次报错 “fatal: The current branch xxx has no upstream branch” 怎么办
这是最常见的上游分支缺失场景：本地新建分支后直接 git push，Git 不知道该推到远程哪个分支。本质不是“没设置”，而是“没关联”——Git 需要明确知道 origin/feature/login 是当前 feature/login 的上游。
解决方法只有一条命令：git push -u origin HEAD（推荐）或 git push -u origin feature/login。其中 -u（即 --set-upstream）会同时完成两件事：把本地分支推到远程，并在本地配置 branch.feature/login.merge 和 branch.feature/login.remote 这两个配置项。
-
HEAD写法更安全：不用手输分支名，避免拼错；尤其适合从git checkout -b新建后立刻推送的场景 - 如果远程仓库还没创建对应分支（比如
origin是空仓库），这条命令会自动创建它 - 执行后，后续
git pull和git push就能省略参数，直接走上游关系
已经推过但没加 -u，怎么补设 upstream
有人第一次用 git push origin feature/login 成功了，但忘了加 -u，结果下次 git pull 报错 “There is no tracking information for the current branch”。这不是 Git 拒绝工作，而是它压根没记这个映射关系。
补设不用删分支重来，用 git branch --set-upstream-to=origin/feature/login 即可（注意是 =，不是空格）。也可以简写为 git branch -u origin/feature/login。
- 必须在目标分支上执行（比如先
git checkout feature/login） - 远程分支名必须存在，否则会提示 “not a valid object name”
- 如果远程分支名和本地不一致（比如本地叫
dev，想跟踪origin/main），这里可以自由指定，不强制同名
git config 中 upstream 相关配置长什么样
上游关系最终落地为 Git 配置项，藏在 .git/config 里。执行完 git branch -u origin/feature/login 后，你会看到类似这段：
[branch "feature/login"] remote = origin merge = refs/heads/feature/login
这两行就是全部。其中 remote 指定用哪个远程仓库（可配多个），merge 指定远程的哪个引用（通常是 refs/heads/xxx，即分支）。
- 别手动改这个文件——用
git branch -u更可靠，避免格式错误 - 如果删掉这两行，就等价于取消 upstream 关系，
git status会显示 “Your branch is up to date with 'origin/feature/login'.” 消失 -
git branch -vv能直观看到所有分支的 upstream 状态，带[origin/feature/login]表示已关联，[no upstream]表示未关联
多人协作时 upstream 设错会导致什么问题
最典型的误操作：在 main 分支上执行了 git branch -u origin/dev，导致 git pull 时悄悄合并 origin/dev 到 main。这种错位不会报错，但会污染主干历史，且难以回溯。
- 每次切换分支后，用
git branch -vv快速确认当前分支的 upstream 是否合理 - CI/CD 流程中依赖
git merge-base @{u}做增量构建时，上游设错会让基线计算完全失效 - IDE（如 VS Code）的 Git 面板、状态栏分支提示都依赖这个配置，设错后“未推送提交数”“落后提交数”全不准
上游分支不是一次性设置完就高枕无忧的事，它随着分支生命周期动态变化——重命名远程分支、更换默认远程仓库、重构协作流程时，都得重新核对。最稳妥的做法是：每次 git checkout 后，顺手敲一行 git branch -vv。
