Hello World · GitHub指南

Hello World 项目是计算机程序编程中流传已久的传统。 这是一个简单的练习，让你开始学习新的东西。 让我们开始使用GitHub！

你将学会如何:

• 新建并使用一个仓库
• 新建并管理一个新的分支
• 更改文件，并将其作为提交推送到GitHub
• 新建以及合并一个pull请求

GitHub是什么?

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

本教程教你使用GitHub的一些基础要素，如repositories，branches，commits和Pull Requests。 你将创建自己的Hello World仓库，并学习GitHub的Pull Request工作流程，这是一种流行的创建和查看代码的方式。

无需编码

要完成本教程，你需要一个GitHub账户和Internet访问。你不需要知道如何编写代码，使用命令行或安装Git（GitHub所基于的版本控制软件）。

提示: 请在另一个浏览器窗口或页面打开这个教程，那么你可以看见。在单独的浏览器窗口（或页面）中打开本教程，以便在完成相应步骤时可以看到它。

Step 1. 创建一个仓库

一个仓库通常用于组织单个项目。仓库可以包含文件夹和文件，图像，视频，电子表格和数据集，即项目需要的任何内容。 我们建议您添加一个README或包含您项目信息的文件。Github让你很轻松地能在创建新的仓库的同时添加一个项目说明文件。 _它还提供其他常见选项，如许可证文件。

你的hello-world仓库可以是你存储想法，资源以及与他人分享和讨论的地方。

如何创建一个新的仓库

1. 在页面右上角，你的头像或提示符旁边，单击加号，然后选择**新的存储库。
2. 将你的仓库命名为hello-world。
3. 写一段简短的描述。
4. 选择Initialize this repository with a README（使用README文件初始化这个仓库）。

点击 Create repository（创建仓库）.

Step 2. 创建分支

分支是同时在不同版本的存库上工作的方式。

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

当您从master分支创建分支时，你就是在创建master的副本或快照，因为它是基于该时间节点的。 如果有人在你在分支上工作时对master分支进行了更改，那么你可以更新更改内容。

本图显示:

• master 分支
• 一个名为feature的新分支（因为我们在这个分支上做feature相关的工作）
• feature分支在合并到master前需要经历的流程

你有没有保存过不同版本的文件？就像这样：

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

分支在GitHub仓库中完成了类似的目标。

在GitHub中，我们的开发人员，作家和设计师使用分支来保持bug修复，并将功能与我们的master（生产）分支分离开来。 当一个变更完成，他们才将其的分支合并到master。

如何创建新分支

1.进入新仓库hello-world。

2.点击文件列表顶部的下拉列表，它显示 branch：master 。

3.在新的分支文本框中输入一个分支名称readme-edits。

4.选择蓝色的创建分支框，或者在键盘上点击Enter。

现在你有两个分支，master和readme-edits。 它们看起来完全一样，但不会一直一样！接下来，我们将添加对新分支的更改。

Step 3. 创建和提交变更

好样的！ 现在，你正在查看readme-edits分支的代码内容，它是master分支的副本。 让我们进行一些编辑吧。

在GitHub上，保存的更改称为commits（提交）。 每个提交都有一个关联的commit message（提交信息），这是一个描述为什么进行特定更改的描述。 提交信息记录了你变更的历史，因此其他贡献者可以了解你做了什么以及为什么做。

如何创建和提交变更

1. 点击README.md文件。
2. 单击文件视图右上角的铅笔图标进行编辑。
3. 在编辑时，写点儿关于你自己的东西。
4. 写一个描述你的更改的提交信息。
5. 单击提交变更按钮。

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

Step 4. 发起一个pull请求

编辑得很好！ 现在您已经在readme-edits中创建了不同于master的更改，可以发起一个pull 请求。

pull请求是GitHub协作的核心。 当你发起一个pull 请求时，你在提议你的修改，并请求其他人检查并合并你的贡献，并将变更并入他们的分支。 pull请求显示两个分支的内容的差异（diff或differences）。 更改内容包括新增和删除内容显示为绿色和红色。

一旦你发起提交，你可以发起一个pull请求并开始一场讨论，这些甚至能在代码完成之前开始。

通过在pull请求消息中使用GitHub的@mention系统 ，你可以要求来自特定人员或团队的反馈，无论他们是近在大厅还是远在10个时区之外。

您甚至可以在自己的存储库中打开提取请求，并自行合并。 在开展大型项目之前，了解GitHub Flow是一个很好的方式。

发起一个更改README的pull请求

点击图片可观看大图

步骤截图

单击Pull Requesttab，然后在pull请求页面中，单击绿色的New pull request（新的pull请求）按钮。

选择你创建的分支readme-edits，和master（源）分支进行比较。

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

当你确定这些是你想要提交的更改时，请点击绿色的Create Pull Request大按钮。

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

当你填写完信息后，点击Create pull request!

提示: 你可以在评论和pull请求中使用 emoji 以及 拖放图像和gifs 。

Step 5. 合并pull请求

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

1. 点击绿色Merge pull request按钮将更改合并到master分支中。
2. 点击Confirm merge。
3. 然后删除分支，因为它的更改已被合并，点击紫色框中的删除分支按钮。

祝贺!

通过实践这个教程，你已经学会了如何在Github上创建一个仓库并发起一个pull请求!

下面是对你在本教程中所完成内容的总结：

• 创建一个开源代码库
• 启动并管理新的分支机构
• 更改了一个文件，并将这些变更提交给GitHub
• 发起并合并pull请求

看查你的GitHub配置文件，你会看到你的新的贡献方块！

要了解有关Pull请求功能的更多信息，我们建议您阅读GitHub流程指南。 您也可以访问GitHub Explore并参与开源项目