Menu
CoddyTech

Git:设置上游分支

最后更新

分支的上游是它所跟踪的远程分支。设置好之后,直接运行 git push 和 git pull,Git 就知道该把提交发到哪里、从哪里获取,不用每次都写远程仓库和分支名。通常在第一次推送时用 -u 设置,之后也可以用 git branch --set-upstream-to 设置。

在终端在线编辑器中试试这些命令:浏览器里就是真正的 shell,无需安装。

设置上游会把本地分支和对应的远程分支关联起来,这样直接运行 git push 和 git pull 就知道该去哪里。

语法

命令作用
git push -u origin feature一步完成推送和设置上游
git branch --set-upstream-to=origin/feature为当前分支设置上游
git branch -u origin/feature feature为指定分支设置上游
git branch -vv显示每个分支及其上游

常见用法

目标命令
第一次推送时设置上游git push -u origin feature
为已有分支设置上游git branch --set-upstream-to=origin/feature
查看设置了哪个上游git branch -vv

Git 设置上游分支常见问题

设置上游分支有什么作用?
它把你的本地分支和某个远程分支关联起来。之后在这个分支上执行 git push 和 git pull,Git 就知道要用哪个远程仓库和分支,你可以不带参数直接运行。Git 还会在 git status 中显示你领先或落后上游多少个提交。
怎么设置上游分支?
最简单的方法是在第一次推送时设置:git push -u origin <branch> 会同时完成推送和设置上游。如果远程已经有这个分支,切换到该分支后运行 git branch --set-upstream-to=origin/<branch>。
怎么查看分支的上游?
运行 git branch -vv。它会列出你的本地分支,并标注每个分支的上游(例如 [origin/feature])以及领先或落后的情况。没有上游的分支,方括号部分不会显示任何内容。
为什么 git push 要我设置上游?
因为当前分支没有配置上游,Git 不知道该推送到哪里。运行一次 git push -u origin <branch> 设置好上游,之后只需要 git push 就行。
可以在线练习吗?

可以。打开终端在线编辑器,就能在浏览器里的真实 shell 中运行这些命令,无需安装。Coddy 的免费互动 Git 课程也会一步步教你使用远程仓库。

Coddy 编程语言插图

在 Coddy 学习 Git

开始