Git远程操作详解

作者: 阮一峰

日期: 2014年6月12日

Git是目前最流行的版本管理系统,学会Git几乎成了开发者的必备技能。

Git有很多优势,其中之一就是远程操作非常简便。本文详细介绍5个Git命令,它们的概念和用法,理解了这些内容,你就会完全掌握Git远程操作。

  • git clone
  • git remote
  • git fetch
  • git pull
  • git push

本文针对初级用户,从最简单的讲起,但是需要读者对Git的基本用法有所了解。同时,本文覆盖了上面5个命令的几乎所有的常用用法,所以对于熟练用户也有参考价值。

git

一、git clone

远程操作的第一步,通常是从远程主机克隆一个版本库,这时就要用到git clone命令。


$ git clone <版本库的网址>

比如,克隆jQuery的版本库。


$ git clone https://github.com/jquery/jquery.git

该命令会在本地主机生成一个目录,与远程主机的版本库同名。如果要指定不同的目录名,可以将目录名作为git clone命令的第二个参数。


$ git clone <版本库的网址> <本地目录名>

git clone支持多种协议,除了HTTP(s)以外,还支持SSH、Git、本地文件协议等,下面是一些例子。


$ git clone http[s]://example.com/path/to/repo.git/
$ git clone ssh://example.com/path/to/repo.git/
$ git clone git://example.com/path/to/repo.git/
$ git clone /opt/git/project.git 
$ git clone file:///opt/git/project.git
$ git clone ftp[s]://example.com/path/to/repo.git/
$ git clone rsync://example.com/path/to/repo.git/

SSH协议还有另一种写法。


$ git clone [user@]example.com:path/to/repo.git/

通常来说,Git协议下载速度最快,SSH协议用于需要用户认证的场合。各种协议优劣的详细讨论请参考官方文档

二、git remote

为了便于管理,Git要求每个远程主机都必须指定一个主机名。git remote命令就用于管理主机名。

不带选项的时候,git remote命令列出所有远程主机。


$ git remote
origin

使用-v选项,可以参看远程主机的网址。


$ git remote -v
origin  [email protected]:jquery/jquery.git (fetch)
origin  [email protected]:jquery/jquery.git (push)

上面命令表示,当前只有一台远程主机,叫做origin,以及它的网址。

克隆版本库的时候,所使用的远程主机自动被Git命名为origin。如果想用其他的主机名,需要用git clone命令的-o选项指定。


$ git clone -o jQuery https://github.com/jquery/jquery.git
$ git remote
jQuery

上面命令表示,克隆的时候,指定远程主机叫做jQuery。

git remote show命令加上主机名,可以查看该主机的详细信息。


$ git remote show <主机名>

git remote add命令用于添加远程主机。


$ git remote add <主机名> <网址>

git remote rm命令用于删除远程主机。


$ git remote rm <主机名>

git remote rename命令用于远程主机的改名。


$ git remote rename <原主机名> <新主机名>

三、git fetch

一旦远程主机的版本库有了更新(Git术语叫做commit),需要将这些更新取回本地,这时就要用到git fetch命令。


$ git fetch <远程主机名>

上面命令将某个远程主机的更新,全部取回本地。

git fetch命令通常用来查看其他人的进程,因为它取回的代码对你本地的开发代码没有影响。

默认情况下,git fetch取回所有分支(branch)的更新。如果只想取回特定分支的更新,可以指定分支名。


$ git fetch <远程主机名> <分支名>

比如,取回origin主机的master分支。


$ git fetch origin master

所取回的更新,在本地主机上要用"远程主机名/分支名"的形式读取。比如origin主机的master,就要用origin/master读取。

git branch命令的-r选项,可以用来查看远程分支,-a选项查看所有分支。


$ git branch -r
origin/master

$ git branch -a
* master
  remotes/origin/master

上面命令表示,本地主机的当前分支是master,远程分支是origin/master

取回远程主机的更新以后,可以在它的基础上,使用git checkout命令创建一个新的分支。


$ git checkout -b newBrach origin/master

上面命令表示,在origin/master的基础上,创建一个新分支。

此外,也可以使用git merge命令或者git rebase命令,在本地分支上合并远程分支。


$ git merge origin/master
# 或者
$ git rebase origin/master

上面命令表示在当前分支上,合并origin/master

四、git pull

git pull命令的作用是,取回远程主机某个分支的更新,再与本地的指定分支合并。它的完整格式稍稍有点复杂。


$ git pull <远程主机名> <远程分支名>:<本地分支名>

比如,取回origin主机的next分支,与本地的master分支合并,需要写成下面这样。


$ git pull origin next:master

如果远程分支是与当前分支合并,则冒号后面的部分可以省略。


$ git pull origin next

上面命令表示,取回origin/next分支,再与当前分支合并。实质上,这等同于先做git fetch,再做git merge


$ git fetch origin
$ git 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主机"追踪分支"(remote-tracking branch)进行合并。

如果当前分支只有一个追踪分支,连远程主机名都可以省略。


$ git pull

上面命令表示,当前分支自动与唯一一个追踪分支进行合并。

如果合并需要采用rebase模式,可以使用--rebase选项。


$ git pull --rebase <远程主机名> <远程分支名>:<本地分支名>

如果远程主机删除了某个分支,默认情况下,git pull 不会在拉取远程分支的时候,删除对应的本地分支。这是为了防止,由于其他人操作了远程主机,导致git pull不知不觉删除了本地分支。

但是,你可以改变这个行为,加上参数 -p 就会在本地删除远程已经删除的分支。


$ git pull -p
# 等同于下面的命令
$ git fetch --prune origin 
$ git fetch -p

五、git push

git push命令用于将本地分支的更新,推送到远程主机。它的格式与git pull命令相仿。


$ git push <远程主机名> <本地分支名>:<远程分支名>

注意,分支推送顺序的写法是<来源地>:<目的地>,所以git pull是<远程分支>:<本地分支>,而git push是<本地分支>:<远程分支>。

如果省略远程分支名,则表示将本地分支推送与之存在"追踪关系"的远程分支(通常两者同名),如果该远程分支不存在,则会被新建。


$ git push origin master

上面命令表示,将本地的master分支推送到origin主机的master分支。如果后者不存在,则会被新建。

如果省略本地分支名,则表示删除指定的远程分支,因为这等同于推送一个空的本地分支到远程分支。


$ git push origin :master
# 等同于
$ git push origin --delete master

上面命令表示删除origin主机的master分支。

如果当前分支与远程分支之间存在追踪关系,则本地分支和远程分支都可以省略。


$ git push origin

上面命令表示,将当前分支推送到origin主机的对应分支。

如果当前分支只有一个追踪分支,那么主机名都可以省略。


$ git push

如果当前分支与多个主机存在追踪关系,则可以使用-u选项指定一个默认主机,这样后面就可以不加任何参数使用git push


$ git push -u origin master

上面命令将本地的master分支推送到origin主机,同时指定origin为默认主机,后面就可以不加任何参数使用git push了。

不带任何参数的git push,默认只推送当前分支,这叫做simple方式。此外,还有一种matching方式,会推送所有有对应的远程分支的本地分支。Git 2.0版本之前,默认采用matching方法,现在改为默认采用simple方式。如果要修改这个设置,可以采用git config命令。


$ git config --global push.default matching
# 或者
$ git config --global push.default simple

还有一种情况,就是不管是否存在对应的远程分支,将本地的所有分支都推送到远程主机,这时需要使用--all选项。


$ git push --all origin

上面命令表示,将所有本地分支都推送到origin主机。

如果远程主机的版本比本地版本更新,推送时Git会报错,要求先在本地做git pull合并差异,然后再推送到远程主机。这时,如果你一定要推送,可以使用--force选项。


$ git push --force origin 

上面命令使用--force选项,结果导致远程主机上更新的版本被覆盖。除非你很确定要这样做,否则应该尽量避免使用--force选项。

最后,git push不会推送标签(tag),除非使用--tags选项。


$ git push origin --tags

(完)

留言(77条)

现在公司用的就是Git. 感谢总结!

个人觉得最重要的东西反而不是pull(这个还不如先fetch,再merge或者rebase),而是gitk……
有时候弄了半天会lost掉不知道local repo究竟处于什么奇怪的状态,gitk来看看commite graph厘清怎么处理才是最重要的。

其他advanced command估计博主以后会提我就不提了。

我想增加一条.gitignore 小建议。

已读,顶一下。

$ git push origin master
上面命令表示,将本地的master分支推送到origin主机的master分支。如果后者不存在,则会被新建。
如果省略本地分支名,则表示删除指定的远程分支,因为这等同于推送一个空的本地分支到远程分支。

$ git push origin :master
# 等同于
$ git push origin --delete master
上面命令表示删除origin主机的master分支。

似乎第一条命令的解释写错了吧?两条命令都是 git push origin :master, 解释不同

最好不要混混淆 git merge 和 git rebase,这是不同的操作。

配图很好地解释了几个概念

git最有特色的是本地分支功能

HG也不错。

阮兄,首页的图片改为全屏后没法看啊,画面太渣。还是原尺寸好

您好, 阮老师! 我是今年河南的应届考生 ,对您的个人魅力十分崇拜 。我的高考分数602 ,请问怎样才能成为您的学生?

我是firefox插件vimperator的忠实用户,习惯于浏览网页时用键盘操作。所以我设置了快捷键 [[ 对应跳转 上一页|上一张|上一篇|上一章 等等, 快捷键 ]] 对应跳转 下一页|下一张|下一篇|下一章 等等。

问题是,您的博客页面上, 上一篇|下一篇 都不是可点击的链接,必须点击右边的标题才能跳转。所以我无法用快捷键跳转。

阮老师,您能把 上一篇|下一篇 写进标签吗,谢谢!

@雷明庆:

页面里已经加了link rel="prev"/"next"了。

一直用的是for window的那个图形界面版本,感觉应该试试这个命令行的了

引用阮一峰的发言:

@雷明庆:

页面里已经加了link rel="prev"/"next"了。


验证成功了!
博主听取别人意见并改进,值得我们学习!

页面添加这个功能,容易实现吗?怎么弄的?

灰常棒啊

引用朱俊星的发言:

您好, 阮老师! 我是今年河南的应届考生 ,对您的个人魅力十分崇拜 。我的高考分数602 ,请问怎样才能成为您的学生?

加油~同为河南人。
你考的不错,不一定要成为他的学生,也可以成为他的朋友。
大学里好好学习~

引用朱俊星的发言:

您好, 阮老师! 我是今年河南的应届考生 ,对您的个人魅力十分崇拜 。我的高考分数602 ,请问怎样才能成为您的学生?

多看阮老师博客文章不就行了?呵呵。

引用RedNax的发言:

个人觉得最重要的东西反而不是pull(这个还不如先fetch,再merge或者rebase),而是gitk……
有时候弄了半天会lost掉不知道local repo究竟处于什么奇怪的状态,gitk来看看commite graph厘清怎么处理才是最重要的。

我没装gitk,我看这些通常是用到:
git log --all --decorate --graph

感觉把远程主机改叫远程仓库更合适一些。

讲的非常棒!非常简单明了!比网上其他好的git的介绍棒多了!

我觉得初学者最好是先把Rebase搞清楚,哈哈哈哈,不然被人鄙视。。。

图片里面fetch和pull的功能弄反了。

博主能说说fork操作吗?我有个问题,就是在我fork了一个项目之后,如果原项目又更新了代码,我自己fork的项目怎么做到和原项目同步呢?

向你学习

引用Timothy的发言:

感觉把远程主机改叫远程仓库更合适一些。

恰恰相反,楼主用「主机」这个称呼,我一下子明了了。

Git 文档里直接就叫 remote,仍然觉得抽象,虽然我知道它的含义。

阮哥,最后 git push --force origin 时,如果远程主机上分支比自己本地的新,不会发生『non-fast-forward merge』,事实上会覆盖远程主机上的提交,导致提交丢失,多人协同下很少会用 --force 选项,而 non-fast-forward 只在 merge 时才可能发生。其它地方也有些小错误,不过影响都不大。

@Bravluna:

谢谢指出,已经修改了。

引用浪漫小生的发言:

讲的非常棒!非常简单明了!比网上其他好的git的介绍棒多了!

你看过其他的教程吗?
百度“git教程”第一个网站 廖雪峰的

真的不能更赞,对我来说帮助太大了,跟字典一样。

非常实用

感谢,写的很不错

引用朱俊星的发言:

您好, 阮老师! 我是今年河南的应届考生 ,对您的个人魅力十分崇拜 。我的高考分数602 ,请问怎样才能成为您的学生?

好好编程,进阿里你们就相见了。

remote: ERROR: committer email address [email protected]
remote: ERROR: does not match your user account.
remote: ERROR:
remote: ERROR: The following addresses are currently registered:
remote: ERROR: [email protected]

! [remote rejected] master -> master (invalid committer)
error: failed to push some refs to 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX

! [remote rejected] master -> master (invalid committer)
error: failed to push some refs to 'ssh://code.ctripcorp.com:29418/Flight/Mobile

我使用 git config --global user.email "[email protected]"后,还是不行,push后依然显示这个错,请问如何解决?

@raywang:

仔细看,第二条命令master前边有“:”,而第一条没有

“如果省略远程分支名,则表示将本地分支推送与之存在"追踪关系"的远程分支(通常两者同名),如果该远程分支不存在,则会被新建”这里这样描述很容易给人歧义,$ git push origin master ,这里不应该提到“追踪关系”,很容易让人想到是不是追踪分支,虽然楼主加了双引号,事实上,这种关系楼主你知道是怎么产生的么?或者说在哪里有类似和追踪分支一样的设置

“如果当前分支与远程分支之间存在追踪关系,则本地分支和远程分支都可以省略。
$ git push origin
上面命令表示,将当前分支推送到origin主机的对应分支”

事实上,不是追踪分支关系的分支作为当前分支,也可以执行git push origin,所以这里上面那样写是不是不对?

学习了,很受用。

阮老师,把背景设为#dddddd吧,看黄色背景刺眼的很。

请问 git remote -v 之后
origin [email protected]:developers/hljk365.git (fetch)
origin [email protected]:developers/hljk365.git (push)

这两个后面的fetch 和push 是什么意思啊

学习了,谢谢,分享让世界更加的美好。

远程主机翻译为远程仓库是否更准确一些?

http://git-scm.com/book/en/v2/Git-Basics-Working-with-Remotes
Remote repositories are...

谢谢,讲得很清楚

感谢博主的总结~

引用过客的发言:

“如果当前分支与远程分支之间存在追踪关系,则本地分支和远程分支都可以省略。
$ git push origin
上面命令表示,将当前分支推送到origin主机的对应分支”

事实上,不是追踪分支关系的分支作为当前分支,也可以执行git push origin,所以这里上面那样写是不是不对?

推动是可以,但是没有任何效果! 因为simple模式下,git没有找到对应的远程分支,所以,没有任何操作。

学到东西了,很有用。

有一个添加文件到特定remote的问题。我先clone了一个名字叫try的repo:
git clone github.com/try.git
然后我用gitstack在本地电脑上创建一个空的remote:http://localhost/try.git,接着添加了这个remote:
git remote add jacky http://localhost/try.git
这都没有问题。我最后想把我repo里的文件(就是从github.com/try.git clone下来的文件)给push到jacky这个remote的时候,发现根本一个文件都没有push上去:
git push jacky master

我的问题是怎样才能把本地repo(try文件夹)里面的文件push到jacky这个remote?谢谢大家的耐心和时间!

文章很实用,我是新学git,32个赞.

pull那里是不是说错了,pull只是会覆盖本地仓库,但不会覆盖工作区间

非常感谢,受益匪浅,解释清晰到位

博主,请问题头的那个图是用什么工具画的?

我git本地 删除8.php文件

rm 8.php
git rm 8.php
commit -m "del 8.php"

我现在想把远程库中的8.php文件同步回本地
执行 git pull origin master 提示已经是最新版本了

但我执行git push origin master将本地同步到远程库是可以的

非常好的入门,没有过多的废话,入门就是要这样直击要害,细节知识自己搜就行。

终于明白fetch的作用了!! 谢谢!

此外,也可以使用git merge命令或者git rebase命令,在本地分支上合并远程分支。


$ git merge origin/master
# 或者
$ git rebase origin/master

上面命令表示在当前分支上,合并origin/master。

git merge origin/master 和 git rebase origin/master 不是一回事吧。

git push --force origin不是覆盖,是在远端合并吧

我要怎么关注你啊??????

简单明了,值得收藏。从文字里面,感受到博主认真负责的品格。即将奔赴职场,每次看到这样专业的博文的时候,总是很感动。

pull不是应该包含fetch吗?图里是不是有点问题?

阮哥,有两点疑惑:
1.git pull应该是将本地仓库和工作区都更新吧? git pull的路线加一条箭头到本地仓库?
2.check out是现将暂存区的更新到工作区吧? 如果暂存区先有add,再修改工作区,然后check out,发现是将add后的状态恢复到工作区了

git remote add 怎么叫主机名呢,好难理解,这个不是就是一个分支的名字吗,为什么叫主机?

引用王一的发言:

远程主机翻译为远程仓库是否更准确一些?

http://git-scm.com/book/en/v2/Git-Basics-Working-with-Remotes
Remote repositories are...

我也这么认为,主机这个翻译好奇怪,还以为是个电脑呢,感觉应该叫远程仓库分支才对

引用raywang的发言:

似乎第一条命令的解释写错了吧?两条命令都是git push origin :master, 解释不同

没有错,第一条命令是省略了远程分支名,第二条命令前边有个冒号,是省略了本地分支名。

总结得很好,感谢

阮老师写的特别清晰、条理,赞

勘误:$ git checkout -b newBrach origin/master => newBranch

勘误:pull 是本地仓库和工作台都会覆盖。

写的很好,总结的很好,然后看了一下,老师有本书,于是买下来看看

通过git的实际表现,我发现再 remote和repository之间还存在一个仓库?

Remote->(fetch)->origin/repository->(merge)->repository ?

http://omjq5ny0e.bkt.clouddn.com/15231740463034.jpg

总结的超级详细 客观 基本不带一点个人色彩 很可贵

--set-upstream已经不被支持了,现在是--track或者--set-upstream-to,希望改正

@max:

我也发现了get fetch并不是把代码放到本地分支

git fetch
没有从remote到repository

@raywang:

老哥,你没看清楚。push 命令完整版是 git push <远程主机名> <本地分支名>:<远程分支名> ,其中分支方向和pull是相反的。git push origin master 这个命令是省略了远程分支,git push origin :master 这个命令是省略了本地分支。

阮老师pull我也有看到别的文里面给的原理图,结合我自己的使用,我觉得pull应该是拉到Repository才对,您为啥是pull是到workspace?

参考这篇文章,解决了! [rejected] main -> main (fetch first)问题。用到了以下命令:
git fetch origin main
git branch -r # 结果是不是origin/main
git merge origin/main
或者
git rebase origin/main

git push origin main
搞定了。
其实如果遵从好的git工作流就不会有上面问题。
阮老师写的东西都是真东西!

引用zhaoyun的发言:

勘误:pull 是本地仓库和工作台都会覆盖。

git pull 之前先执行 git stash 再执行git pull 最后执行git stash pop即可解决覆盖的问题。

我要发表看法

«-必填

«-必填,不公开

«-我信任你,不会填写广告链接