GitHub 的 10 分钟快速入门教程

Hello World

这一篇是 GitHub 的 10 分钟快速入门教程，因为找不到中文版，大橙子自己给大家翻译了一下。

Hello World 项目是计算机编程的一个历史悠久的传统。这一篇我们也通过这个简单的练习让你学习到新的知识。那么就让我们开始 GitHub 的学习旅程吧！

通过本教程，你将会学习到：

创建和使用一个仓库
开始并管理一个新的分支
修改文件并作为提交推送到 GitHub
开启并合并一个 Pull Request

What is GitHub?

GitHub 是一个版本控制和协作的代码托管平台。无论你和小伙伴们身处何地，它都可以让你们一起合作开发项目。

这个教程教你一些 GitHub 的基本要领，像仓库、分支、提交和 Pull Requests。你将创建你自己的 Hello World 仓库并学会 GitHub 的 Pull Request 的工作流程（创建和审查代码的一种流行方式）。

不需要任何代码

学习这篇教程，你只需要一个 GitHub.com 的账号和畅通的互联网环境在这里插入图片描述）；不要求你懂得如何编程，或者使用命令行，亦或者安装 Git。

**提示：**将本页面作为一个单独的浏览器窗口（或标签）打开，这样你可以依葫芦画瓢地完成本教程中的步骤。

第一步：创建一个仓库

仓库通常是用来组织一个项目的。仓库可以存放文件夹、文件、图片、视频、电子表格还有数据集 —— 任何你的项目需要的内容。

我们推荐你在项目中包含一个 README 文件，或者建立一个可以查看项目信息的文件。在 GitHub 上，一旦你创建一个新的仓库，就可以很容易地创建一个 README 文件和 license 文件（用于声明版权）。

你的 hello-world 仓库可以是一个分享想法，资源，甚至是和其他小伙伴讨论交流的地方。

创建一个新的仓库

在页面的右上角，点击头像隔壁的“+”号，选择 New repository
将你的仓库命名为 hello-world
为该项目写上一段简短的描述
勾选 Initialize this repository with a README（为该仓库初始化一个 README 文件）
最后点击 Create repository

第二步：创建一个分支
在这里插入图片描述

通过分支的方式，允许你在同一时间对仓库不同版本的内容进行操作。

默认情况下，你的仓库中拥有一个叫做 master 的分支，它被认为是主分支。我们可以建立不同的分支进行测试和编辑，完善以后再提交至 master。

当你在 master 建立一个分支时，你拷贝的是当时 master 分支里的内容。如果其他小伙伴修改了主分支的内容，你可以将这些更新的内容拉取到你的分支上。
在这里插入图片描述
下图展示了以下几点内容：

master 分支
一个新的分支叫做 feature（因为我们希望在这个分支上增加一些新功能）
feature 分支在合并到 master 之前的所作所为

在这里插入图片描述

你有没有试过像下边这样保存一个文件的不同版本：

story.txt
story-joe-edit.txt
story-joe-edit-reviewed.txt

GitHub 仓库的分支就是类似这样实现的。

在 GitHub 中，我们的开发人员、作家、设计师在分支上修复 bug 和开发新功能，这些都是独立于 master 分支的。当这些工作确认完成之后，他们将合并回 master 分支。

创建一个新的分支

来到你的新仓库 hello-world 中
点击那个叫做 branch: master 的下拉按钮
在新分支的文本框中输入你的分支名称：readme-edits
单击蓝色框框中的 Create branch 或直接回车键走起

现在你拥有了两个分支：master 和 readme-edits。它们看起来贼像，但这只是暂时的！下面我们将修改添加到新的分支里。

第三步：提交修改

哇哦！现在你位于 readme-edits 分支的代码视图了，它是拷贝自 master 分支的。让我们做些修改吧！

在 GitHub 上，保存修改被称为提交（commits）。每次提交都有一个关联的提交信息，用于描述你做所的修改。提交信息将捕获你的修改历史，这样其他小伙伴就能知道你到底干了啥。

提交修改

点击 README.md 文件
点击文件视图右上角的铅笔图标进行编辑
在编辑框中，随便写一些东西
在下边填写提交信息并描述你的修改

在这里插入图片描述

最后点击 Commit changes 按钮

这些修改只影响了 readme-edits 分支的 README 文件，而 master 的 README 文件并没有被改变，所以现在两个分支的内容已经不同了。

第四步：发起 Pull Request

写得好！现在你拥有一个非 master 分支的修改，你可以发起一个 pull request。

Pull Requests 是 GitHub 实现合作的核心。当你发起一个 pull request 的时候，表示你希望别人将你修改的内容进行审查然后合并到他们的分支中去。

Pull Requests 会显示每个分支的不同之处，添加（绿色）和删减（红色）的地方都会显示出来。

只要执行一次提交，就可以开启一个 pull request 和讨论，不需要你将所有的代码都完成。

通过使用 GitHub 的 @ 通知系统，你可以获得指定小伙伴或团队（无论他们身在何处）对 pull requset 的反馈消息。

你也可以在自己的仓库中开启 pull requests 并将它们合并进来。这是你在进行大项目开发前先熟悉 GitHub 流程的好方法。

为修改过的 README 文件开启一个 Pull Request

点击图片可以查看大图

步骤演示
点击 Pull Request 标签，然后在 Pull Request 页面中点击 New pull request 按钮
在这里插入图片描述
选中 readme-edits 分支，用于和 master（原始）分支进行对比

在对比页面查看两个分支的不同，确保你希望提交的内容正确

当你确认所有待提交的内容正确无误之后，点击页面上方那个绿色的按钮 Create Pull Request
为你的 pull request 操作写一个标题以及简短的说明
在这里插入图片描述
完成之后，点击 Create pull request 按钮即可。

提示：你可以使用 emoji 表情，还可以拖拽图片到说明窗口中。

第五步：合并你的 Pull Request

最后一个步骤，是时候将你的修改合并到一块了 —— 合并你的 readme-edits 分支到 master 分支中。

点击绿色按钮 Merge pull request 将修改的内容合并到 master 分支中
点击 Confirm merge 按钮
点击紫色框中的 Delete branch 按钮删除分支，因为它已经合并进来了。

在这里插入图片描述

庆祝！

通过完成本教程，你学会了如何创建一个项目，并在 GitHub 上拉取请求（Pull Request）！

下面是你在本教程中学到的内容：

创建和使用一个仓库
开始并管理一个新的分支
修改文件并作为提交推送到 GitHub
开启并合并一个 Pull Request

GitHub 的 10 分钟快速入门教程

猜你喜欢