几个简单的Github操作

如何使用GitHub

目标:

  • 了解如何创建和使用代码库
  • 了解创建并管理分支
  • 了解如何将修改过的文件提交到代码库
  • 开启并合并一个上传请求

创建代码库(远程仓库/repository)

  1. 点击右上角的+号下拉菜单,选择创建代码库(New repository)。
  2. 输入仓库的名字,比如hello-world。
  3. 对仓库进行简短的描述。
  4. 选择仓库类型,目前公开的是免费的,私有的需要付费,视个人情况而定。
  5. 接着选择用README文件初始化仓库,同时根据需要选择代码的证书。
    如下图:

create repository

创建分支

一般一个项目开发,最起码有4个分支:产品分支(product)、测试分支(test)、开发分支(development)、主分支(master).
如果需要开发几个大的功能,而且是团队开发,那么需要在dev的基础上创建自己的分支,即创建一个dev分支的复制。
如下图,展示了feature分支完整的生命周期。

分支生命周期

现在,我们只演示一下如何在master分支上创建分支。

  1. 进入刚才创建的代码库的页面。
  2. 点击分支的下拉框,在搜索框内输入新的分支名字,如readme-edits
  3. 点击创建分支
    如下图:

此处输入图片的描述

修改代码并提交(commit)修改

现在,我们的代码库有2个分支:master和readme-edits。
我们在readme-edits分支上,对本来的readme文件进行修改,然后将改动提交上去。
每次提交修改的时候,我们需要输入一些备注,这样可以让别人看到你修改的目的和内容等等,同时也帮助自己以后对项目的复看(review)。
接下来,我们进行文件修改和提交:

  1. 点击打开README.md的文件
  2. 点击右侧的修改按钮(铅笔形状),进入修改页面。
  3. 对文件进行修改
  4. 之后,输入备注
  5. 选择是否创建新的分支,还是提交到当前分支,默认提交到当前分支
  6. 点击提交修改
    具体操作如下图:

此处输入图片的描述

建立一个上传请求(Pull Request)

经过上述步骤后,我们想比较master进行,进行了修改,而且提交了修改,这时候,我们需要发送一次请求,将修改合并到master分支上。
现在,来创建一个上传请求:

  1. 点击Pull Request标签,进入页面,点击创建新请求(New pull request)

此处输入图片的描述

  1. 选择创建的分支,与master分支,进行比较

此处输入图片的描述

  1. 浏览你做的修改,并和master分支进行比较,确保是你想要提交的东西。

此处输入图片的描述

  1. 当你确保这些修改是你想要提交的修改,点击绿色的创建上传按钮。

此处输入图片的描述

  1. 给你的这次请求写一个标题,同时写简短的描述

此处输入图片的描述

允许请求,合并代码

最后,将readme-edits分支合并到master分支:

  1. 点击合并请求按钮,将分支合并到master分支
  2. 点击确认合并
  3. 当合并完成后,就可以删除readme-edits分支了。

此处输入图片的描述

此处输入图片的描述

至此,已经完成了Github的一些基本操作。

本文原文:https://guides.github.com/activities/hello-world/