GitHub使用教程

You’ll learn how to:

创建和使用存储库
启动和管理新分支
对文件进行更改并将其推送到GitHub作为提交
打开并合并拉取请求

What is GitHub?

GitHub是用于版本控制和协作的代码托管平台。 它可以让你和其他人在任何地方的在一个项目中工作。

本教程教你GitHub的要素，如仓库，分支，提交和Pull请求。 您将创建自己的Hello World存储库，并学习GitHub的Pull Request工作流程，这是一种创建和查看代码的常用方法。

No coding necessary

要完成本教程，您需要一个GitHub.com帐户和Internet访问。 你不需要知道如何编码，使用命令行，或安装Git。
提示：在单独的浏览器窗口（或选项卡）中打开此指南（https://github.com/），以便在完成教程中的步骤时可以看到它。

Step 1. Create a Repository

存储库通常用于组织单个项目。 存储库可以包含文件夹和文件，图像，视频，电子表格和数据集 - 项目需要的任何内容。 我们建议包括README或包含有关项目信息的文件。 GitHub使得在创建新存储库的同时添加一个东西很容易。 它还提供其他常见选项，如许可证文件。

您的世界仓库可以是您存储想法，资源，甚至与他人分享和讨论内容的地方。

To create a new repository

在右上角，在您的头像或识别码旁边，单击，然后选择新存储库。
命名您的存储库hello-world。
写一个简短的描述。
选择使用README初始化此存储库。

Step 2. Create a Branch

分支是一次在不同版本的仓库上工作的方式。

默认情况下，你的仓库有一个名为master的分支，它被认为是最终分支。 我们使用分支进行实验和编辑，然后提交他们。

当您在主分支上创建分支时，您正在创建主节点的副本或快照，因为它在该时间点。 如果有人在您在分支上工作时对主分支进行了更改，则可以提取这些更新。

此图显示：
主分支
一个新的分支叫次分支（因为我们在这个分支上做“特征工作”）
次分支在合并成主分支之前所需要的旅程

分支在GitHub存储库中实现类似的目标。

在GitHub，我们的开发人员，作家和设计师使用分支来保持错误修复和功能工作独立于我们的主（生产）分支。 当更改准备就绪时，它们将其分支合并到主节点。

To create a new branch

转到您的新存储库hello-world。
单击文件列表顶部的下拉菜单，其中显示branch：master。
在新分支文本框中键入分支名称readme-edits。
选择蓝色的创建分支框或按键盘上的“Enter”。

现在你有两个分支，master和readme-edits。 他们看起来完全一样，但不长久！ 接下来，我们将把更改添加到新分支。

Step 3. Make and commit changes

现在，你在readme-edits分支的代码视图，这是master的副本。 让我们进行一些编辑。

在GitHub上，保存的更改称为提交。 每个提交都有一个相关的提交消息，这是一个描述为什么进行特定更改的描述。 提交消息可捕获更改的历史记录，因此其他参与者可以了解您的操作以及原因。

Make and commit changes

单击README.md文件。
点击文件视图右上角的铅笔图标进行编辑。
在编辑器中，写一点关于你自己的信息。
编写描述您的更改的提交消息。
单击提交更改按钮。

这些更改将只发生在readme-edits分支上的README文件，因此现在此分支包含与master不同的内容。

Step 4. Open a Pull Request

现在，您在master之外的分支中有更改，您可以打开拉式请求。

拉取请求是GitHub上协作的核心。 当您打开拉式请求时，建议您进行更改，并请求某人审核并提交您的提案，并将其合并到他们的分支中。 拉取请求显示来自两个分支的内容的差异或差异。 变化，添加和减少以绿色和红色显示。

一旦提交，就可以打开一个pull请求并开始讨论，在代码完成之前。

通过在您的请求消息中使用GitHub的@mention系统，您可以请求特定人员或团队的反馈，无论他们在哪里。

您甚至可以在您自己的存储库中打开请求并自行合并它们。 这是一个很好的方式来学习GitHub。

Open a Pull Request for changes to the README

打开对README的更改的Pull请求

单击拉请求选项卡，然后从拉请求页面，单击绿色新拉请求按钮。

选择您所做的分支readme-edits，以与master（原始）进行比较。

查看比较页面上差异的更改，确保它们是您要提交的内容。

当您确定这些是您要提交的更改时，单击大的绿色“创建请求”按钮。

给你的pull请求一个标题，并写一个简短的描述你的更改。

完成您的邮件后，点击创建请求！
提示：您可以使用表情符号并将图片和GIF拖放到评论和拉式请求上。

Step 5. Merge your Pull Request

在这最后一步，是时候把你的更改一起 - 将你的readme-edits分支合并到主分支。

单击绿色合并拉请求按钮将更改合并到主。
单击确认合并。
继续并删除分支，因为它的更改已被合并，删除分支按钮在紫色框中。

Celebrate!
通过完成本教程，您已经学会了创建一个项目，并在GitHub上发出pull请求！

看看你的GitHub个人资料，你会看到你的新贡献方块！

要了解有关Pull请求的强大功能，
我们建议您阅读GitHub流程指南。 https://guides.github.com/introduction/flow/
您还可以访问GitHub浏览并参与开源项目 https://github.com/explore

提示：有关如何开始使用GitHub（https://guides.github.com/）的更多信息，请参阅我们的其他指南，YouTube频道和按需培训。