GitHub介绍与使用

目录

    • 1 使用GitHub的目的
    • 2 基本概念
      • 2.1 Repository(仓库)
      • 2.2 Star(收藏)
      • 2.3 Fork(叉子)
      • 2.4 Pull Request(发起请求)
      • 2.5 Watch(关注)
      • 2.6 Issue(事物卡片)
    • 3 注册GitHub
    • 4 新建仓库
      • 4.1 创建步骤
      • 4.2 仓库首页
    • 5 仓库管理
      • 5.1 创建文件
      • 5.2 编辑文件
      • 5.3 删除文件
      • 5.4 上传文件
      • 5.5 搜索仓库文件
      • 5.6 下载仓库/项目
    • 6 Issues
    • 7 Fork
    • 8 个人主页
    • 9 开源项目贡献方法与流程
      • 9.1 新建Issue
      • 9.2 发起pull request

1 使用GitHub的目的

目的是借助GitHub托管项目代码。

2 基本概念

2.1 Repository(仓库)

仓库是用来存放项目的代码,每个项目对应一个仓库,多个开源项目则有多个仓库。

2.2 Star(收藏)

收藏项目,方便下次查看。(在GitHub上面想获得100个star都很不容易)

2.3 Fork(叉子)

有点类似复制克隆项目。你开源了一个项目,别人想在你这个项目的基础上做些改进,然后应用到自己的项目中,这个时候他就可以Fork你的项目(打开项目主页,点击右上角的fork按钮即可),然后他的GitHub主页上就多了一个项目,只不过这个项目是基于你的项目基础(本质上是在原有的项目基础上新建了一个分支),他就可以随心所欲去改进,但是丝毫不会影响原有项目的代码与结构。
但是会有提示:forked from xxx

2.4 Pull Request(发起请求)

别人fork你的项目之后,并对项目做了修改,这时候你的项目还是原来的项目,不会收到影响。但是别人可以向你发送一个pull request请求,你如果觉得他的修改不好,不予理会即可;但是如果你觉得他的修改不错,可以进行一个合并操作,这时你的项目就会添加别人修改的部分,发生变化。

2.5 Watch(关注)

如果你watch了某个项目,那么以后只要这个项目有任何更新,你都会第一时间收到关于这个项目的更新通知提醒。

2.6 Issue(事物卡片)

当发现别人的仓库代码出现Bug或有对其代码有疑问时,可以通过Issue来和代码的作者进行咨询和讨论。作者可以收到别人的提问,然后可以回复。回复完成可以关闭当前的Issue。

3 注册GitHub

直接登陆网站:https://github.com/
首页显示登陆和注册两个选项,注意:sign in是登录,sign up是注册。
如果是QQ邮箱注册,需要添加白名单(具体操作百度),才可以接受到GitHub的验证邮件。

4 新建仓库

通常一个仓库保存一个开源项目,通过git来管理GitHub项目。

4.1 创建步骤

GitHub介绍与使用_第1张图片

4.2 仓库首页

GitHub介绍与使用_第2张图片

5 仓库管理

5.1 创建文件

GitHub介绍与使用_第3张图片
进入下面的页面,
GitHub介绍与使用_第4张图片
对当前页面下拉,
GitHub介绍与使用_第5张图片
创建成功后,自动跳转到下面的页面
GitHub介绍与使用_第6张图片
从对修改文件的概述点进去,进入下面的页面
GitHub介绍与使用_第7张图片

5.2 编辑文件

GitHub介绍与使用_第8张图片
GitHub介绍与使用_第9张图片
对原文件删除了},再从修改文件的概述那里点进去,页面如下所示
GitHub介绍与使用_第10张图片

5.3 删除文件

首先点击文件名,进入如下页面
GitHub介绍与使用_第11张图片
删除也可以写相关概述和描述,并作为1次提交。
查看已经删除了的文件的相关信息:
GitHub介绍与使用_第12张图片
解决方法:
GitHub介绍与使用_第13张图片
GitHub介绍与使用_第14张图片

5.4 上传文件

GitHub介绍与使用_第15张图片
GitHub介绍与使用_第16张图片
上传文件也要写文件的概述和详细描述,最后作为1次提交。
GitHub介绍与使用_第17张图片
上传成功
GitHub介绍与使用_第18张图片

5.5 搜索仓库文件

GitHub介绍与使用_第19张图片

5.6 下载仓库/项目

GitHub介绍与使用_第20张图片

6 Issues

作用:发现别人的仓库代码出现Bug或有疑问时,可以通过Issue来和代码的作者进行咨询和讨论。然后作者可以收到别人的提问,并进行回复。作者回复完成后,可以关闭当前的Issue。
GitHub介绍与使用_第21张图片
GitHub介绍与使用_第22张图片
GitHub介绍与使用_第23张图片
GitHub介绍与使用_第24张图片
点进去看别人提的issue的详细描述,还可以回复别人:
GitHub介绍与使用_第25张图片
GitHub介绍与使用_第26张图片
当作者和读者完成交流后,作者就可以关闭当前的issue。

7 Fork

别人仓库的代码可以克隆到自己的账号下(自己账号下面直接多了一个仓库),可以对仓库进行更改,自己在仓库中对bug进行更改不会影响原作者的仓库,但是可以把自己的修改通过pull request发给作者,如果作者认同你的修改,在接收到你的pull request之后,可以进行一个merge(合并)操作,然后作者自己仓库的项目发生改变;如果作者不认同你的修改,收到你的pull request之后,完全可以忽略。

8 个人主页

GitHub介绍与使用_第27张图片
在个人主页右上角点击头像的下拉菜单:
GitHub介绍与使用_第28张图片

9 开源项目贡献方法与流程

9.1 新建Issue

当你对别人的项目有什么建议或疑问时,可以新建一个issue,与作者沟通。

9.2 发起pull request

当你觉得别人的项目有缺陷时,并且你解决了这个缺陷,可以向作者发起一个pull request请求,如果作者觉得你确实解决了他的bug,他就可以进行合并你的修改,这样他的项目发生了改变,同时修复了bug。步骤如下:
(1)fork别人的项目;
(2)在自己的仓库修改代码;
(3)发起pull request;
(4)等待作者操作(审核、合并)。

你可能感兴趣的:(GitHub&Git)