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介绍与使用
文章图片

4.2 仓库首页
GitHub介绍与使用
文章图片

5 仓库管理 5.1 创建文件
GitHub介绍与使用
文章图片

进入下面的页面,
GitHub介绍与使用
文章图片

对当前页面下拉,
GitHub介绍与使用
文章图片

创建成功后,自动跳转到下面的页面
GitHub介绍与使用
文章图片

从对修改文件的概述点进去,进入下面的页面
GitHub介绍与使用
文章图片

5.2 编辑文件
GitHub介绍与使用
文章图片

GitHub介绍与使用
文章图片

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

5.3 删除文件
首先点击文件名,进入如下页面
GitHub介绍与使用
文章图片

删除也可以写相关概述和描述,并作为1次提交。
查看已经删除了的文件的相关信息:
GitHub介绍与使用
文章图片

解决方法:
GitHub介绍与使用
文章图片

GitHub介绍与使用
文章图片

5.4 上传文件
GitHub介绍与使用
文章图片

GitHub介绍与使用
文章图片

上传文件也要写文件的概述和详细描述,最后作为1次提交。
GitHub介绍与使用
文章图片

上传成功
GitHub介绍与使用
文章图片

5.5 搜索仓库文件
GitHub介绍与使用
文章图片

5.6 下载仓库/项目
GitHub介绍与使用
文章图片

6 Issues 作用:发现别人的仓库代码出现Bug或有疑问时,可以通过Issue来和代码的作者进行咨询和讨论。然后作者可以收到别人的提问,并进行回复。作者回复完成后,可以关闭当前的Issue。
GitHub介绍与使用
文章图片

GitHub介绍与使用
文章图片

GitHub介绍与使用
文章图片

GitHub介绍与使用
文章图片

点进去看别人提的issue的详细描述,还可以回复别人:
GitHub介绍与使用
文章图片

GitHub介绍与使用
文章图片

当作者和读者完成交流后,作者就可以关闭当前的issue。
7 Fork 别人仓库的代码可以克隆到自己的账号下(自己账号下面直接多了一个仓库),可以对仓库进行更改,自己在仓库中对bug进行更改不会影响原作者的仓库,但是可以把自己的修改通过pull request发给作者,如果作者认同你的修改,在接收到你的pull request之后,可以进行一个merge(合并)操作,然后作者自己仓库的项目发生改变;如果作者不认同你的修改,收到你的pull request之后,完全可以忽略。
8 个人主页 GitHub介绍与使用
文章图片

在个人主页右上角点击头像的下拉菜单:
GitHub介绍与使用
文章图片

9 开源项目贡献方法与流程 9.1 新建Issue
当你对别人的项目有什么建议或疑问时,可以新建一个issue,与作者沟通。
9.2 发起pull request
【GitHub介绍与使用】当你觉得别人的项目有缺陷时,并且你解决了这个缺陷,可以向作者发起一个pull request请求,如果作者觉得你确实解决了他的bug,他就可以进行合并你的修改,这样他的项目发生了改变,同时修复了bug。步骤如下:
(1)fork别人的项目;
(2)在自己的仓库修改代码;
(3)发起pull request;
(4)等待作者操作(审核、合并)。

    推荐阅读