Git是目前最流行的版本管理系统,学会Git几乎成了开发者的必备技能。
Git有很多优势,其中之一就是远程操作非常简便。本文详细介绍5个Git命令,它们的概念和用法,理解了这些内容,你就会完全掌握Git远程操作。
- git clone
- git remote
- git fetch
- git pull
- git push
本文针对初级用户,从最简单的讲起,但是需要读者对Git的基本用法有所了解。同时,本文覆盖了上面5个命令的几乎所有的常用用法,所以对于熟练用户也有参考价值。
一、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
(完)
Echo 说:
现在公司用的就是Git. 感谢总结!
2014年6月12日 16:52 | # | 引用
RedNax 说:
个人觉得最重要的东西反而不是pull(这个还不如先fetch,再merge或者rebase),而是gitk……
有时候弄了半天会lost掉不知道local repo究竟处于什么奇怪的状态,gitk来看看commite graph厘清怎么处理才是最重要的。
其他advanced command估计博主以后会提我就不提了。
2014年6月12日 17:50 | # | 引用
gshmu 说:
我想增加一条.gitignore 小建议。
2014年6月12日 19:19 | # | 引用
林晨 说:
已读,顶一下。
2014年6月13日 10:27 | # | 引用
raywang 说:
$ git push origin master
上面命令表示,将本地的master分支推送到origin主机的master分支。如果后者不存在,则会被新建。
如果省略本地分支名,则表示删除指定的远程分支,因为这等同于推送一个空的本地分支到远程分支。
$ git push origin :master
# 等同于
$ git push origin --delete master
上面命令表示删除origin主机的master分支。
似乎第一条命令的解释写错了吧?两条命令都是 git push origin :master, 解释不同
2014年6月13日 11:17 | # | 引用
mine260309 说:
最好不要混混淆 git merge 和 git rebase,这是不同的操作。
2014年6月13日 13:01 | # | 引用
fakenerd 说:
配图很好地解释了几个概念
2014年6月15日 18:17 | # | 引用
chuan 说:
git最有特色的是本地分支功能
2014年6月16日 16:43 | # | 引用
EggBig 说:
HG也不错。
2014年6月17日 21:10 | # | 引用
csj 说:
阮兄,首页的图片改为全屏后没法看啊,画面太渣。还是原尺寸好
2014年6月21日 00:20 | # | 引用
朱俊星 说:
您好, 阮老师! 我是今年河南的应届考生 ,对您的个人魅力十分崇拜 。我的高考分数602 ,请问怎样才能成为您的学生?
2014年6月25日 02:30 | # | 引用
雷明庆 说:
我是firefox插件vimperator的忠实用户,习惯于浏览网页时用键盘操作。所以我设置了快捷键 [[ 对应跳转 上一页|上一张|上一篇|上一章 等等, 快捷键 ]] 对应跳转 下一页|下一张|下一篇|下一章 等等。
问题是,您的博客页面上, 上一篇|下一篇 都不是可点击的链接,必须点击右边的标题才能跳转。所以我无法用快捷键跳转。
阮老师,您能把 上一篇|下一篇 写进标签吗,谢谢!
2014年6月26日 19:52 | # | 引用
阮一峰 说:
@雷明庆:
页面里已经加了link rel="prev"/"next"了。
2014年6月27日 00:03 | # | 引用
ysbinang 说:
一直用的是for window的那个图形界面版本,感觉应该试试这个命令行的了
2014年6月29日 22:59 | # | 引用
royaso 说:
验证成功了!
博主听取别人意见并改进,值得我们学习!
页面添加这个功能,容易实现吗?怎么弄的?
2014年7月 1日 06:50 | # | 引用
yanhaijing 说:
灰常棒啊
2014年7月 3日 10:50 | # | 引用
张杨 说:
加油~同为河南人。
你考的不错,不一定要成为他的学生,也可以成为他的朋友。
大学里好好学习~
2014年7月 5日 08:00 | # | 引用
苹果园子 说:
多看阮老师博客文章不就行了?呵呵。
2014年7月 8日 15:13 | # | 引用
詹臻臻 说:
我没装gitk,我看这些通常是用到:
git log --all --decorate --graph
2014年7月 8日 15:17 | # | 引用
Timothy 说:
感觉把远程主机改叫远程仓库更合适一些。
2014年7月 9日 13:20 | # | 引用
浪漫小生 说:
讲的非常棒!非常简单明了!比网上其他好的git的介绍棒多了!
2014年8月 8日 17:03 | # | 引用
摩摩诘 说:
我觉得初学者最好是先把Rebase搞清楚,哈哈哈哈,不然被人鄙视。。。
2014年8月 9日 22:09 | # | 引用
ynwzhao 说:
图片里面fetch和pull的功能弄反了。
2014年8月24日 13:55 | # | 引用
guobosheng 说:
博主能说说fork操作吗?我有个问题,就是在我fork了一个项目之后,如果原项目又更新了代码,我自己fork的项目怎么做到和原项目同步呢?
2014年8月25日 09:56 | # | 引用
秘鲁进口玛卡 说:
向你学习
2014年9月 2日 14:36 | # | 引用
seatle 说:
恰恰相反,楼主用「主机」这个称呼,我一下子明了了。
Git 文档里直接就叫 remote,仍然觉得抽象,虽然我知道它的含义。
2014年9月 3日 02:21 | # | 引用
Bravluna 说:
阮哥,最后 git push --force origin 时,如果远程主机上分支比自己本地的新,不会发生『non-fast-forward merge』,事实上会覆盖远程主机上的提交,导致提交丢失,多人协同下很少会用 --force 选项,而 non-fast-forward 只在 merge 时才可能发生。其它地方也有些小错误,不过影响都不大。
2014年9月27日 11:13 | # | 引用
阮一峰 说:
@Bravluna:
谢谢指出,已经修改了。
2014年9月27日 20:17 | # | 引用
笔尖 说:
你看过其他的教程吗?
百度“git教程”第一个网站 廖雪峰的
2014年10月12日 21:20 | # | 引用
ShelWee 说:
真的不能更赞,对我来说帮助太大了,跟字典一样。
2014年11月 4日 17:53 | # | 引用
apple 说:
非常实用
2014年11月 4日 20:42 | # | 引用
shadow 说:
感谢,写的很不错
2014年11月15日 15:18 | # | 引用
风老前辈 说:
好好编程,进阿里你们就相见了。
2014年11月24日 17:06 | # | 引用
Rock 说:
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后依然显示这个错,请问如何解决?
2014年12月18日 21:34 | # | 引用
764 说:
@raywang:
仔细看,第二条命令master前边有“:”,而第一条没有
2014年12月23日 11:54 | # | 引用
过客 说:
“如果省略远程分支名,则表示将本地分支推送与之存在"追踪关系"的远程分支(通常两者同名),如果该远程分支不存在,则会被新建”这里这样描述很容易给人歧义,$ git push origin master ,这里不应该提到“追踪关系”,很容易让人想到是不是追踪分支,虽然楼主加了双引号,事实上,这种关系楼主你知道是怎么产生的么?或者说在哪里有类似和追踪分支一样的设置
2015年1月29日 00:41 | # | 引用
过客 说:
“如果当前分支与远程分支之间存在追踪关系,则本地分支和远程分支都可以省略。
$ git push origin
上面命令表示,将当前分支推送到origin主机的对应分支”
事实上,不是追踪分支关系的分支作为当前分支,也可以执行git push origin,所以这里上面那样写是不是不对?
2015年1月29日 01:55 | # | 引用
Zhehua Chang 说:
学习了,很受用。
2015年2月 1日 17:03 | # | 引用
red.hu 说:
阮老师,把背景设为#dddddd吧,看黄色背景刺眼的很。
2015年2月 5日 10:48 | # | 引用
yimiyan 说:
请问 git remote -v 之后
origin [email protected]:developers/hljk365.git (fetch)
origin [email protected]:developers/hljk365.git (push)
这两个后面的fetch 和push 是什么意思啊
2015年4月29日 17:35 | # | 引用
ender 说:
学习了,谢谢,分享让世界更加的美好。
2015年5月28日 10:59 | # | 引用
王一 说:
远程主机翻译为远程仓库是否更准确一些?
http://git-scm.com/book/en/v2/Git-Basics-Working-with-Remotes
Remote repositories are...
2015年7月16日 14:03 | # | 引用
KenzieChen 说:
谢谢,讲得很清楚
2015年7月17日 23:19 | # | 引用
陈熊猫 说:
感谢博主的总结~
2015年7月20日 09:43 | # | 引用
xue 说:
推动是可以,但是没有任何效果! 因为simple模式下,git没有找到对应的远程分支,所以,没有任何操作。
2015年8月 2日 22:41 | # | 引用
haoming 说:
学到东西了,很有用。
2015年8月19日 11:13 | # | 引用
haoming 说:
有一个添加文件到特定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?谢谢大家的耐心和时间!
2015年8月19日 11:49 | # | 引用
杨镇同 说:
文章很实用,我是新学git,32个赞.
2015年10月 9日 09:28 | # | 引用
luffy 说:
pull那里是不是说错了,pull只是会覆盖本地仓库,但不会覆盖工作区间
2015年11月 2日 14:21 | # | 引用
hefengxian 说:
非常感谢,受益匪浅,解释清晰到位
2015年11月16日 14:56 | # | 引用
chrisren 说:
博主,请问题头的那个图是用什么工具画的?
2016年3月13日 16:04 | # | 引用
xmg 说:
我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将本地同步到远程库是可以的
2016年3月29日 15:14 | # | 引用
zoho 说:
非常好的入门,没有过多的废话,入门就是要这样直击要害,细节知识自己搜就行。
2016年5月 3日 18:48 | # | 引用
Henry 说:
终于明白fetch的作用了!! 谢谢!
2016年7月11日 10:26 | # | 引用
skip 说:
此外,也可以使用git merge命令或者git rebase命令,在本地分支上合并远程分支。
$ git merge origin/master
# 或者
$ git rebase origin/master
上面命令表示在当前分支上,合并origin/master。
git merge origin/master 和 git rebase origin/master 不是一回事吧。
2016年7月29日 11:54 | # | 引用
john 说:
git push --force origin不是覆盖,是在远端合并吧
2016年11月21日 17:58 | # | 引用
xiaofengqqcom123 说:
我要怎么关注你啊??????
2016年11月21日 22:16 | # | 引用
DuxiangLin 说:
简单明了,值得收藏。从文字里面,感受到博主认真负责的品格。即将奔赴职场,每次看到这样专业的博文的时候,总是很感动。
2016年12月26日 16:30 | # | 引用
lyn 说:
pull不是应该包含fetch吗?图里是不是有点问题?
2017年4月10日 09:17 | # | 引用
stron 说:
阮哥,有两点疑惑:
1.git pull应该是将本地仓库和工作区都更新吧? git pull的路线加一条箭头到本地仓库?
2.check out是现将暂存区的更新到工作区吧? 如果暂存区先有add,再修改工作区,然后check out,发现是将add后的状态恢复到工作区了
2017年7月 7日 11:36 | # | 引用
li 说:
git remote add 怎么叫主机名呢,好难理解,这个不是就是一个分支的名字吗,为什么叫主机?
2017年9月 1日 14:07 | # | 引用
li 说:
我也这么认为,主机这个翻译好奇怪,还以为是个电脑呢,感觉应该叫远程仓库分支才对
2017年9月 1日 14:09 | # | 引用
qedqef 说:
没有错,第一条命令是省略了远程分支名,第二条命令前边有个冒号,是省略了本地分支名。
2017年11月30日 15:07 | # | 引用
liu 说:
总结得很好,感谢
2017年12月 2日 20:30 | # | 引用
石头 说:
阮老师写的特别清晰、条理,赞
2017年12月 5日 14:15 | # | 引用
王洁玉 说:
勘误:$ git checkout -b newBrach origin/master => newBranch
2017年12月25日 11:03 | # | 引用
zhaoyun 说:
勘误:pull 是本地仓库和工作台都会覆盖。
2018年1月13日 14:01 | # | 引用
晨星 说:
写的很好,总结的很好,然后看了一下,老师有本书,于是买下来看看
2018年4月11日 09:55 | # | 引用
max 说:
通过git的实际表现,我发现再 remote和repository之间还存在一个仓库?
Remote->(fetch)->origin/repository->(merge)->repository ?
http://omjq5ny0e.bkt.clouddn.com/15231740463034.jpg
2018年4月13日 14:19 | # | 引用
丢火车 说:
总结的超级详细 客观 基本不带一点个人色彩 很可贵
2019年5月24日 15:07 | # | 引用
booboo 说:
--set-upstream已经不被支持了,现在是--track或者--set-upstream-to,希望改正
2019年7月20日 09:57 | # | 引用
erlie 说:
@max:
我也发现了get fetch并不是把代码放到本地分支
2019年10月10日 20:17 | # | 引用
erlie 说:
git fetch
没有从remote到repository
2019年10月10日 20:24 | # | 引用
王卫振 说:
@raywang:
老哥,你没看清楚。push 命令完整版是 git push <远程主机名> <本地分支名>:<远程分支名> ,其中分支方向和pull是相反的。git push origin master 这个命令是省略了远程分支,git push origin :master 这个命令是省略了本地分支。
2020年1月22日 11:09 | # | 引用
哈蛋 说:
阮老师pull我也有看到别的文里面给的原理图,结合我自己的使用,我觉得pull应该是拉到Repository才对,您为啥是pull是到workspace?
2020年5月28日 17:15 | # | 引用
阮老师小迷弟 说:
参考这篇文章,解决了! [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工作流就不会有上面问题。
阮老师写的东西都是真东西!
2021年8月11日 17:30 | # | 引用
阮老师小迷弟 说:
git pull 之前先执行 git stash 再执行git pull 最后执行git stash pop即可解决覆盖的问题。
2021年8月11日 19:20 | # | 引用