GitHub 的基本用法

---

什么是 GitHub？

GitHub 是一个代码托管平台，用于版本控制和团队协作，它可以使多人在不同地点一起合作完成同一个项目。GitHub 中包含一些要素，比如：库，分支，提交以及合并请求等。

创建并使用一个库

一个库通常被用于组织一个单独的项目，其中可以包含：文件夹、文件、图片、视频、电子表格以及 DataSet 等，推荐在项目中包含一个 README 文件或者一个用于介绍项目概要信息的文件，GitHub 会在创建新库的同时自动添加一个 README.md 文件。

具体步骤

1. 在右上角靠近用户头像的位置点击 +，选择 New repository；
2. 在 Repository name 处的文本框中输入新库的名称；
3. 在 Description (optional) 处输入关于库的描述（可选）；
4. 选择 Public（免费）或 Private（收费）的库属性；
5. 选择 Initialize this repository with a README 来让 GitHub 自动生成一个 README.md 文件来对库进行说明；
6. 最后点击绿色的Create repository按钮完成库的创建。
   

新建并管理一个分支

分支是同一个库同时工作在不同版本的方式，在默认情况下，新建的库中只有一个名为 master 的分支，它被认为是最终分支（版本）。当创建 master 分支以外的其它分支时，最初得到的是一份当前 master 分支的拷贝；在提交文件的最终版本到 master 分支之前，应当使用其它分支进行实验或者编辑修改文件内容，之后再将修改合并到 master 分支中。
下图展示了一个叫做 feature 的新分支合并到 master 分支之前必须要经历的过程：

具体步骤

1. 点击新创建的库；
2. 点击列表按钮Branch: master；
3. 在文本框中输入要创建的新分支的名字；
4. 选择 Create branch: 选项或者直接在文本框中回车来完成新分支的创建。
   

对分支中的内容作出修改并将其提交

在 GitHub 上，保存修改的操作被称为 commit（提交），每个 commit 都关联着一条 commit message（提交信息），它是一个针对所做修改的描述信息，即 commit message 中记录了所作修改的历史信息，这样其他合作者就能够获知别人之前对项目做过哪些修改。

具体步骤

1. 在库的新分支中点击要修改的文件；
2. 点击右上角的铅笔图标打开编辑界面；
3. 在编辑器中修改文件内容；
4. 之后在 Commit changes 中写一个关于修改内容的提交信息，包括标题和具体描述；
5. 点击绿色的Commit changes按钮提交修改。
   

提出一个合并请求

合并请求是在 GitHub 上团队协作的核心操作，提出一个合并请求意味着要向项目团队提交新的修改，合并请求会显示两个分支在内容上的区别，其中添加、修改和删除的内容将被标识为绿色和红色。

具体步骤

1. 在库中点击 Pull requests 标签页；
2. 点击绿色的New pull request按钮；
3. 在 EXAMPLE COMPARISONS 选择框中点击新分支与 master 分支进行内容对比；
4. 确定修改是正确的之后，点击绿色的Create pull request按钮；
5. 给合并请求添加一个标题并给出一个关于合并请求的描述，默认是之前提交的修改操作描述；
6. 最后点击绿色的Create pull request按钮完成合并请求操作。

同意合并请求

这是 GitHub 基本操作中的最后一个步骤，是要正式将新分支的内容合并到 master 分支中去。

具体步骤

1. 点击绿色的Merge pull request按钮；
2. 确认无误后点击绿色的Confirm merge按钮；
3. 点击紫色框中的Delete branch按钮来删除这个临时分支（因为它所做的修改已经被合并到了 master 分支，已经完成了自己的任务）。

至此，已经完成了在 GitHub 上创建一个库、修改项目内容以及做出合并请求的一系列操作。