了解GitHub并开始第一个GitHub项目

GitHub Guides

Hello World 项目经常被作为我们开始学习计算机编程的第一个项目，甚至已经成为一个学习传统。今天我们学习使用GitHub也从这个项目开始吧！

这篇文章可以让你学会以下几点：

• 创建和使用仓库(repository)
• 新建和管理一个分支
• 对文件进行修改并将其作为提交(commits)推送(push)至GitHub
• 打开和合并一个拉取文件请求

什么是GitHub?

GitHub是一个用于版本控制和团队协作的代码托管平台，这个平台使得你和你的团队成员能够在任何地方一起实现一个项目。

本教程教授你一些GitHub的重要功能，比如：仓库(repositories)，分支(branches)，提交(commits)和拉取请求(pull request)。跟随本教程，你将能够完成：

• 创建自己的Hello World仓库(repository)
• 学习GitHub的拉取请求(pull request)工作流
• 创建和检查代码的常用方法

无需编码

电脑能够连接网络并拥有GitHub账户是完成本教程的必要条件。你不需要知道怎样编程，怎样使用命令行，并且不需要安装git（git是一个版本控制软件，GitHub就是基于git创建的）

（Tips:将本教程用独立的窗口或者标签页打开，你可以一边完成步骤，一边查看教程）

第一步：创建和一个仓库(Repository)

通常一个仓库用来组织一整个项目。一个仓库可以包含文件夹、文件、图片、视频、电子表格和数据集——任何你项目需要的文件它都可以包含。我们推荐包含和一个“README”文件，或者其他带有你项目介绍的文件。在GitHub上你新建一个仓库很容易，当然增加一个仓库也很容易。它还提供其他的常见选择比如许可证文件。

你的hello-world仓库可以是你储存想法，资源，或者甚至是分享和与别人讨论问题的一个地方。

创建一个新仓库(repository)

1. 在页面的右上方，头像或者识别框的旁边，点击“+”然后选择 New repository .
2. 将你的仓库命名为 hello-world.
3. 写一段对项目的简短描述
4. 选择“用README初始化这个仓库”.(可能是老版本的缘故，此处，勾选下方需要的选项就好)

点击“创建仓库(Create repository)”.

第二步 创建一个分支(Branch)

分支是一种同时处理不同版本的存储库的方法

在你新建的仓库中有一个名叫main的默认分支，这是一个决定性的分支。我们使用分支进行实验，并在将它们提交到main分支之前进行编辑。

当您在main分支之外创建分支时，您正在制作一个main分支的副本或快照，制作完的副本或快照就只是制作时的修改状况。如果你在工作的时候别人更改了这个main分支，你可以拉入(pull)这些更新。

这个图表展示的是：

• main分支
• 一个叫做feature的新分支(因为我们正在这个分支上做“特色工作”)
• feature分支在被合并到main分支之前经历的过程

你是否曾经保存过不同版本的文件？就像：

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

在github上，我们的开发者，作者和设计人员使用分支(branches)将bug修复和一些特色工作与我们的产品分支(main)分开。当完成了对这些bug的修改整理，它们会将其合并至main分支。

创建一个新分支

1. 到你新创建的hello-world分支中去
2. 点击文件列表上方main分支的下拉菜单
3. 在新分支俭入筐中输入分支名称：readme-edits
4. 用鼠标选择蓝色的 Create branch 或者敲击键盘的回车键

现在你已经有两个分支了，分别时main分支和readme-edits分支，它们暂时看起来是一样的，下一步我们要在新分支中添加我们的改变。

步骤三 做一些改变并进行提交(commit)

非常好！现在你在你的 readme-edits 分支，这个分支还算是 main 分支的复制版本。下面我们对其进行一些编辑。

在Github上，保存更改被叫做“commits”,每一个提交都有一个与之关联的提交信息，这个提交信息用来解释本次提交所作的改变是什么以及为什么要做这些改变。提交记录捕获更改的历史记录，使得其他的贡献者可以了解你所做的事情以及为什么这样做。

做一些更改并提交更改

1. 点击 README.md 文件
2. 点击右上方角落里笔的形状的图标以开始更改。
3. 在作者一栏，简短的写一些自我介绍
4. 写会被关联的提交信息来描述你所做的改变
5. 点击 提交更改 (Commit changes) 按钮

这些改变只会应用于你 readme-edits分支 的 README 文件，因此，现在这个分支包含的内容就不同于 main 分支了。

第四步 打开一个拉取请求(Pull Request)

编辑的不错！现在您已经在 main 分支中进行了更改，您可以打开一个拉取(pull)请求。

拉取请求(pull request)是GitHub上团队协作的核心功能。当你打开一个pull请求时，你正在提议你的更改，请求某人审阅并拉入你的贡献，并将这些更改合并到它们的分支中。pull request显示两个分支的内容的差异。增加和减少等做出修改的位置会以红色和绿色显示。

只要你做了一次提交，甚至在代码写完之前，你就能打开一个pull request并且开始一个讨论。

在您的pull request信息中，无论你的团队成员身处何地，你都能够通过使用GitHub的“mention system”，得到特定人或特定团队的反馈。

你甚至可以在你自己的仓库中打开pull request并且自己合并这些请求。这样在参与大型项目之前，你就可以学习下GitHub的工作流的使用。

打开一个对README文件更改的拉取请求

点开查看大图

步骤	屏幕截图
点击 Pull Resquest 标签页，然后在该页面点击绿色的 New pull request 按钮
在 Example Comparisons 框中，选择你新建的分支 readme-edits ，与原始的分支 main 分支比较以下看看
在比较页面中检查你所做的更改，确保是你想要提交的内容
当你对这些修改很满意时，点击绿色的大按钮 Create Pull Resquest
给你的pull request一个标题并且写一个对你的更改的简短描述

更改完成你的关联信息后，点击 Create pull request ！

Tips:您可以使用表情符号，也可以将图像和动图拖拽到评论区和Pull Requests中

步骤五 合并你的拉取请求(Pull Resquest)

在这最后一步，是时候将你对 readme-edits 分支的改变合并到 main 分支中去了。

1. 点击绿色的 Merge pull request 按钮，将改变合并至 main 分支
2. 点击 Confirm Merge 按钮
3. 继续三处分支，因为它的更改已经合并，使用紫色框中的 delete branch 按钮

祝贺你

跟完了这个教程，你已经学会了在GitHub上创建一个项目并打开一个pull request了！

在本教程中，你完成的内容如下：

• 创建并打开了一个源码仓库
• 新建一个分支，并对其进行整理
• 在GitHub上修改一个文件并且提交哪些修改
• 打开并合并一个Pull Request

看一眼你的GitHub自我介绍(Profile)页面，你会看见你的一个新的贡献广场(contribution squares)~

我们推荐阅读 GitHub flow Guide 来了解更多关于Pull Request 的强大功能。你还可以访问GitHub Explore,探索并参与一个开源项目。

Tip:获取更多关于如何开启GitHub的信息，请访问Guides,YouTube Channel 和On-Deman Training

---

欢迎光顾小编的公共号: mITw