github使用教程（一）-github分布式代码托管服务器使用介绍

一、GitHub出现的背景

    在GitHub没有出现之前，开源项目很容易，但让世界上广大程序员参与进来比较困难，因为用参与，就要提交源代码，而象svn或者vss,cvs这些集中式的代码托管服务器给每个想要提交代码的程序员开一个账号那是不现实的，因此，以前广大的群众也仅限于报一个bug，即使能改掉bug，也只能把diff文件用邮件发过去，很不方便。所以GitHub的出现，解决了开源项目的协作上的这个痛点需求。  

   GitHub作为免费的远程仓库，特别适合开源项目的协作社区，从而实现通过GigHub，既可以让别人参与你的开源项目，也可以参与别人的开源项目，目前成为了世界上最受欢迎的个人开源项目的代码协作版本控制工具。

二、利用GitHub如何参与一个开源项目，即GitHub的开源项目的代码版本控制工作原理：

     第一步：程序员，可以登录GitHub后，访问某一个开源项目的地址，例如BootStrap开源项目主页https://github.com/twbs/bootstrap，点击“Fork（即复制克隆后建立分叉或叫分支）”，在自己的账号下克隆了一个BootStrap仓库。

     第二步：程序员，再从自己的账号下clone（即第一次用于从GitHub远程仓库上克隆项目到本地目录，类似于svn的checkout），例如：

git clone git@github.com:michaelliao/bootstrap.git

一定要从自己的账号下clone仓库，这样你才能推送修改。如果从bootstrap的作者的仓库地址git@github.com:twbs/bootstrap.git克隆(clone)，因为没有权限，你将不能推送修改，原理如图：

Bootstrap的官方仓库twbs/bootstrap、你在GitHub上克隆的仓库my/bootstrap，以及你自己克隆到本地电脑的仓库，他们的关系就像下图显示的那样：

┌─ GitHub ────────────────────────────────────┐
│                                             │
│ ┌─────────────────┐     ┌─────────────────┐ │
│ │ twbs/bootstrap  │────>│  my/bootstrap   │ │
│ └─────────────────┘     └─────────────────┘ │
│                                  ▲          │
└──────────────────────────────────┼──────────┘
                                   ▼
                          ┌─────────────────┐
                          │ local/bootstrap │

第三步：如果你想修复bootstrap的一个bug，或者新增一个功能，立该就可以开始干活，干完后，往自己的远程仓库推送。

第四步：如果你希望bootstrap的官方库能接受你的修改，你就可以在GitHub上发起一个pull request。当然，对方是否接受你的pull request就不一定了。

总结，GitHub对开源项目管理功能：

• 在GitHub上，可以任意Fork开源仓库；

• 自己拥有Fork后的仓库的读写权限；

• 可以推送pull request给官方仓库来贡献代码。

二、github使用简易教程

    1.github支持对外开放和私有仓库，微软收购后，免费支持私有3个用户，但这三个账号采用用github的账号邀请方式，免费私有不支持团队成员管理模式，主仓库的数量免费的个数不限制。

    2.使用github的步骤：

      （1）创建github账号，并且完善个人资料，必须通过邮箱的确认才能注册成功。

       （2）创建仓库即Respository，可以创建多个仓库，在一个仓库下可以创建多个项目，仓库和项目的设计规则：

              一般一个仓库对应一个项目，如果是一产品对应一个项目,通常仓库的名称命名采用项目或者产品名称；

             如果一个产品有多个子项目组成，则可以一个仓库对应多个项目，所以这边的项目指子项目的概念。

        （3）上传项目到仓库

         ( 4)   邀请团队成员，免费的私有支持3个免费的用户，所以邀请时输入成员github注册的邮箱，成员邮件确认后可以加入，这些成员可以管理（即可以删除）。

         （5）github术语翻译：

                 Respository:仓库;

                Star：收藏

                Fork：复制克隆项目，分叉—你开源了一个项目，别人想在你这个项目基础上做些改进，然后应用到自己的项目中，这时他就可以fork你的项目（打开项目主页点击右上角fork按钮即可），然后主页上就多了一个项目（基于你的项目），可以任意进行操作了。

               Pull Request)：发起请求，基于Fork,别人Fork你的项目代码之后，在此基础上做了修改，觉得不错的话，可以Pull Request(简称 PR),原有项目创建人，也就是你，接收到请求之后，可以review他的代码，经测试觉得不错的话，可以接受他的PR,这样他做的改进项目中就会有了。

                Watch：关注(Watch)

                Issue：事务卡片(Issue) ：发现代码BUG,目前没有成型代码，需要讨论时用。解决后可以Close掉。

                GitHub主页：左侧显示用户动态以及关注用户或关注仓库的动态，右侧显示所有的git库。

               仓库主页：主要显示项目的信息，如：项目代码，版本，关注，fork情况等。

               个人主页：个人信息，头像，个人简介，关注我的人，我关注的人，我关注的git库，我的开源项目，我贡献的开源项目等信息。

===============================================

作者单位：北京速融科技有限公司

作者：钟招坤  qq:28582157

行业：担保软件研发

整理日期：2019.2.23

================================================