GitHub初探,远程仓库怎么玩?

最近要和同学一起做一个Android项目,由于需要多人协作开发,所以被推荐使用Git和GitHub进行项目管理,由于之前都没接触过,所以初次使用走弯路什么的也花费了我许多时间,故写篇教程总结下我的使用经验。
Git的基本使用教程可以看我之前的一篇文章:Git的安装与基本使用

1 GitHub是什么?

gitHub是一个面向开源及私有软件项目的托管平台,因为只支持git 作为唯一的版本库格式进行托管,故名gitHub。

gitHub于2008年4月10日正式上线,除了git代码仓库托管及基本的 Web管理界面以外,还提供了订阅、讨论组、文本渲染、在线文件编辑器、协作图谱(报表)、代码片段分享(Gist)等功能。目前,其注册用户已经超过350万,托管版本数量也是非常之多,其中不乏知名开源项目 Rubyon Rails、jQuery、python 等。

2018年6月4日,微软宣布,通过75亿美元的股票交易收购代码托管平台GitHub。

在GitHub,用户可以十分轻易地找到海量的开源代码,随着越来越多的应用程序转移到了云上,Github已经成为了管理软件开发以及发现已有代码的首选方法。

2 GitHub的注册登录

首先进入GitHub的官网:GitHub官网

GitHub首页

在首页输入用户名、邮箱、密码进行注册,具体的流程和其他网站注册差不多,我就不多说了,邮箱验证成功后会让你选择是否充值为付费用户,如果你不需要代码保密的话点击free就可以了,对于个人来说free已经完全够用了。

3 建立一个新的仓库

new repository

登录后找到new repository按钮点击,新建一个仓库。

新建仓库

在Repository name那里为你的远程仓库起个名字,下面的Description可填可不填,为你的项目写上一两句描述,然后选择Public开源(Private是不开源,别人不可见,仅付费用户可选),就可以点击Create repository创建你的远程仓库了。


点击创建成功后会进入这个界面,你可以直接在网上新建项目文件,也可以直接将一个已经写好的项目上传到该仓库中,甚至也能将网上别的代码复制过来初始化你的仓库。为了方便后面的讲述,我选择上传已存在的项目。

4 在你的GitHub账号上添加你电脑的SSH秘钥

生成SSH秘钥
在用户主目录下,看看有没有.ssh目录,如果有,再看看这个目录下有没有id_rsa和id_rsa.pub这两个文件,如果已经有了,可直接跳到下一步。如果没有,打开Git Bash,创建SSH Key:

 ssh-keygen -t rsa -C "youremail@email.com"

把命令里的邮箱地址换成你自己的邮箱,然后便一路回车键按下去,不需要修改什么,用默认值便可以了。

如果没有出什么问题的话,你现在应该可以在你的用户主目录里找到.ssh目录,里面有id_rsa和id_rsa.pub两个文件,这两个就是SSH Key的秘钥对,id_rsa是私钥,不能泄露出去,id_rsa.pub是公钥,告诉其他人也无所谓。
添加SSH秘钥,选择
接下里回到你的GitHub界面,点击右上角头像进入setttings设置界面,选择SSH and GPG keys,然后右上角点击new SSH key,给自己的秘钥起个Title,然后在key文本框里粘贴上id_rsa.pub文件里的内容,点击Add key确认添加即可。

5 从本地上传已存在的项目

在上篇文章中,我在本地建立了一个只有一个readme.txt的本地仓库,同样起名为TestForGit。


进入后界面

readme.txt里面写了两句话,“hello world!”和“I am a man”。
现在在TestForGit文件夹上右键点击Git bash打开Git的命令行界面,输入:

git remote add origin https://github.com/lonelywilliam/TestForGit.git
git push -u origin master

然后push成功会显示:


push成功

你再点开你GitHub上的仓库,会发现里面已经有啦一个readme.txt,那就说明上传成功了。


GitHub上

第一次push时可能会收到一个warning警告,那只是SSH秘钥的确认警告,可以不用理会。

6 本地修改再次提交

我们现在在本地的readme.txt文档上做一个修改,把两句话都删掉,改成“there is nothing!”然后输入指令,在本地提交并查看版本:

git add .
git commit -m "readme.txt is changed"
git log

从图中我们可以看出在本地我们的最新版本已经到了9e02ff1那个了,而origin/master也就是远程仓库的master还停留在上一个4124dbd那个版本。

接下来我们可以将本地的修改push到GitHub上的远程仓库,但我们先不这样做,我们在GitHub上也将这个文件修改一下,看看再push会发生什么情况:



我将GitHub上readme.txt文档新加了一句“I miss her!”。而本地的readme.txt里面已经只剩“there is nothing!”了。
接下来把本地仓库push 上去:



然后Git会报错,报错信息告诉我们这通常是由于另一半仓库已经改变引起的,而且提示我们可以用pull指令先更新下,我们再用git status查看下状态:
git status

它提示我们远程仓库已经有了一次新的commit提交,所以我们还是先用pull指令让远程仓库与本地仓库合并一下吧:

git pull 
冲突

信息显示自动融合(auto-merge)进程在readme.txt这里出现了冲突(conflict),导致融合失败,你需要先修复冲突在提交后才能继续合并。
我们可以输入diff指令查看具体报错信息:

git diff

从这里可以看到这文件在本地与远程仓库有差异,所以需要我们先解决冲突后才能push上去。
行,那我们打开readme.txt文件:



Git已经帮我们把冲突的地方标记出来了,我们把他标记的语句都删掉,然后把语句改成“there is nothing!”和“I miss her!”,这样双方就没有冲突了。接下来继续push三连:

git add .
git commit -m "fix the conflict"
git push

现在我们已经push成功了,再去GitHub上看看有没有修改成功吧!



可以看到,远程仓库也跟本地同步了。
这里要提一下,push三连其实应该改成push四连,因为一般来说上传前让远程与本地同步是必要的步骤。所以正确的提交步骤是:

git add .(添加文件)
git commit -m "your message"(提交)
git pull (拉取远程仓库更新)
git push (推送到远程仓库)

7 如何从远程仓库下载代码

如果我一不小心把本地项目丢失了,或者损坏了,怎么从远程仓库下载呢?
很简单,或许是本篇文章操作最简单的一步了,只需要一个git clone 命令即可。
我先将本地TestForGit项目删除,然后在GitHub远程仓库主页,找到仓库地址复制:


然后找个空位置鼠标右键进入git bash 界面:

git clone https://github.com/lonelywilliam/TestForGit.git(此处填你的远程仓库地址)

然后你指定的位置就已经有了远程仓库的拷贝,是不是超级简单?
而且只要这一条命令,你就可以前往GitHub的开源项程序海洋里寻找你感兴趣的项目,把他们下载到本地调试开发。

8 GitHub界面介绍

个人主页

仓库首页
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,100评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,308评论 3 388
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,718评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,275评论 1 287
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,376评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,454评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,464评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,248评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,686评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,974评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,150评论 1 342
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,817评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,484评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,140评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,374评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,012评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,041评论 2 351

推荐阅读更多精彩内容

  • 1.git的安装 1.1 在Windows上安装Git msysgit是Windows版的Git,从https:/...
    落魂灬阅读 12,657评论 4 54
  • 1. 安装 Github 查看是否安装git: $ git config --global user.name "...
    Albert_Sun阅读 13,649评论 9 163
  • 远程仓库 到目前为止,我们已经掌握了如何在Git仓库里对一个文件进行时光穿梭,你再也不用担心文件备份或者丢失的问题...
    归云丶阅读 1,958评论 0 5
  • 世界一片空白 天上下起了雨 湿了我的鞋 熟悉的气味 来自多年前的那个小村庄 天那么蓝 白云那么高 希望的脸庞 失望...
    showfox阅读 334评论 0 1
  • 闲情偶记·有夜未央 ——八十年初的初秋,大街小巷只有昏黄的几盏路灯。农历八月十五,大人们总会拿些用四方的油纸包裹的...
    sunroot阅读 203评论 0 0