git pull
git pull
命令用于从另一个存储库或本地分支获取并集成(整合)。git pull
取回远程主机某个分支的更新,再与本地的指定分支合并。
语法
git pull [options] [[ …]]
- 将远程存储库中的更改合并到当前分支中。在默认模式下,
git pull
是git fetch
后跟git merge FETCH_HEAD
的缩写。 - 更准确地说,
git pull
使用给定的参数运行git fetch
,并调用git merge
将检索到的分支头合并到当前分支中。 - 使用
git pull --rebase
,它运行git rebase
而不是git merge
。
示例
git pull 远程主机名 远程分支名:本地分支名
比如,要取回 origin 主机的 next 分支,与本地的 master 分支合并,需要写成下面这样:
git pull origin next:master
如果远程分支 next 要与当前分支合并,则冒号后面的部分可以省略。上面命令可以简写为:
git pull origin next
上面命令表示,取回 origin/next 分支,再与当前分支合并。实质上,这等同于先做git fetch
,再执行git merge
。
git fetch origingit merge origin/next
在某些场合,Git 会自动在本地分支与远程分支之间,建立一种追踪关系(tracking)。比如,在git clone
的时候,所有本地分支默认与远程主机的同名分支,建立追踪关系,也就是说,本地的 master 分支自动“追踪” origin/master 分支。Git 也允许手动建立追踪关系。
git branch --set-upstream master origin/next
上面命令指定 master 分支追踪 origin/next 分支。
如果当前分支与远程分支存在追踪关系,git pull
就可以省略远程分支名。
git pull origin
上面命令表示,本地的当前分支自动与对应的 origin 主机“追踪分支”,进行合并。
如果当前分支只有一个追踪分支,连远程主机名都可以省略。
git pull
上面命令表示,当前分支自动与唯一一个追踪分支进行合并。
如果合并需要采用 rebase 模式,可以使用–rebase
选项。
git pull --rebase 远程主机名 远程分支名:本地分支名