github官方使用文档教程

视频指南     GitHub帮助    GitHub.com

10分钟阅                                                                    读

Hello World项目是计算机编程历史悠久的传统。这是一个简单的练习，可以让你在学习新东西时开始学习。让我们开始使用GitHub！

您将学习如何：

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

 

什么是GitHub？

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

本教程教您GitHub基本知识，如存储库，分支，提交和Pull请求。您将创建自己的Hello World存储库并学习GitHub的Pull Request工作流，这是一种创建和审查代码的流行方法。

无需编码

要完成本教程，您需要GitHub.com帐户和Internet访问权限。您不需要知道如何编码，使用命令行或安装Git（基于版本控制软件GitHub）。

提示：在单独的浏览器窗口（或选项卡）中打开本指南，以便在完成本教程中的步骤时看到它。

 

步骤1.创建存储库

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

您的hello-world存储库可以是存储想法，资源，甚至与他人共享和讨论事物的地方。

创建新存储库

1. 在右上角，在您的头像或identicon旁边，单击 然后选择New repository。
2. 命名您的存储库hello-world。
3. 写一个简短的描述。
4. 选择使用自述文件初始化此存储库。

单击创建存储库。

 

第2步。创建一个分支

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

默认情况下，您的存储库有一个名为branch的分支master，它被认为是权威分支。我们使用分支进行实验并在提交之前进行编辑master。

当您在分支机构上创建分支时master，您正在创建该master时间点的副本或快照。如果其他人master在您的分支机构工作时对分支进行了更改，则可以引入这些更新。

该图显示：

• 该master分支
• 一个叫做的新分支feature（因为我们在这个分支上做'特色工作'）
• feature它融入之前的旅程master

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

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

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

在GitHub，我们的开发人员，编写人员和设计人员使用分支来保持错误修复和功能工作与我们的master（生产）分支分开。当更改准备就绪时，它们将其分支合并到master。

创建一个新分支

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

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

 

第3步。制作并提交更改

好样的！现在，您在readme-edits分支的代码视图中，这是一个副本master。我们来做一些编辑。

在GitHub上，保存的更改称为提交。每个提交都有一个关联的提交消息，该消息是解释为何进行特定更改的描述。提交消息可捕获更改的历史记录，因此其他贡献者可以了解您已完成的操作和原因。

制作并提交更改

1. 单击该README.md文件。
2. 点击  要编辑的文件视图右上角的铅笔图标。
3. 在编辑器中，写下一些关于你自己的内容。
4. 编写描述更改的提交消息。
5. 单击提交更改按钮。

这些更改只会在您的readme-edits分支上的README文件中进行，因此现在这个分支包含的内容与之不同master。

 

步骤4.打开Pull请求

很好的编辑！现在您的分支中有更改master，您可以打开拉取请求。

Pull Requests是GitHub上合作的核心。当您打开拉取请求时，您提出了更改并请求某人审核并提取您的贡献并将其合并到他们的分支中。拉请求显示来自两个分支的内容的差异或差异。更改，添加和减少以绿色和红色显示。

提交后，即使在代码完成之前，您也可以打开拉取请求并开始讨论。

通过在拉取请求消息中使用GitHub的@mention系统，您可以询问特定人员或团队的反馈，无论他们是在大厅还是10个时区之外。

您甚至可以在自己的存储库中打开pull请求并自行合并。在开展大型项目之前，这是学习GitHub流程的好方法。

打开Pull Request以更改README

点击图像查看大图

步	截图
点击  “拉取请求”选项卡，然后从“拉取请求”页面中，单击绿色“ 新拉”请求按钮。
在“ 示例比较”框中，选择您要创建的分支readme-edits，以与master（原始）进行比较。
在“比较”页面上查看差异中的差异，确保它们是您要提交的内容。
如果您对要提交的更改感到满意，请单击绿色的“创建拉取请求”按钮。
为您的拉取请求提供标题并写下您的更改的简要说明。

完成邮件后，单击“ 创建拉取请求”！

---

提示：您可以使用的表情符号和拖放图片和GIF到的意见和引入请求。

 

步骤5.合并您的Pull请求

在最后一步中，是时候将您的更改结合在一起 - 将您的readme-edits分支合并到master分支中。

1. 单击绿色合并拉取请求按钮以将更改合并到master。
2. 单击确认合并。
3. 继续删除分支，因为它的更改已合并，紫色框中的删除分支按钮。

庆祝！

通过完成本教程，您已经学会了创建项目并在GitHub上发出拉取请求！

以下是您在本教程中完成的内容：

• 创建了一个开源存储库
• 开始并管理一个新的分支
• 更改了文件并将这些更改提交给GitHub
• 打开并合并了一个Pull Request

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

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

---

提示：查看我们的其他指南，YouTube频道和按需培训，了解有关如何开始使用GitHub的更多信息。

最后更新于2016年4月7日

GitHub是构建和发布软件的最佳方式。
开源和私有项目的强大协作，代码审查和代码管理。

• 视频指南
 
• GitHub帮助
 
• GitHub.com
 

 

你好，世界

 10分钟阅读

 

该的Hello World项目是计算机编程历史悠久的传统。这是一个简单的练习，可以让你在学习新东西时开始学习。让我们开始使用GitHub！

您将学习如何：

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

 

什么是GitHub？

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

本教程教您GitHub基本知识，如存储库，分支，提交和Pull请求。您将创建自己的Hello World存储库并学习GitHub的Pull Request工作流，这是一种创建和审查代码的流行方法。

无需编码

要完成本教程，您需要GitHub.com帐户和Internet访问权限。您不需要知道如何编码，使用命令行或安装Git（基于版本控制软件GitHub）。

提示：在单独的浏览器窗口（或选项卡）中打开本指南，以便在完成本教程中的步骤时看到它。

 

步骤1.创建存储库

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

您的hello-world存储库可以是存储想法，资源，甚至与他人共享和讨论事物的地方。

创建新存储库

1. 在右上角，在您的头像或identicon旁边，单击 然后选择New repository。
2. 命名您的存储库hello-world。
3. 写一个简短的描述。
4. 选择使用自述文件初始化此存储库。

单击创建存储库。

 

第2步。创建一个分支

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

默认情况下，您的存储库有一个名为branch的分支master，它被认为是权威分支。我们使用分支进行实验并在提交之前进行编辑master。

当您在分支机构上创建分支时master，您正在创建该master时间点的副本或快照。如果其他人master在您的分支机构工作时对分支进行了更改，则可以引入这些更新。

该图显示：

• 该master分支
• 一个叫做的新分支feature（因为我们在这个分支上做'特色工作'）
• feature它融入之前的旅程master

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

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

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

在GitHub，我们的开发人员，编写人员和设计人员使用分支来保持错误修复和功能工作与我们的master（生产）分支分开。当更改准备就绪时，它们将其分支合并到master。

创建一个新分支

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

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

 

第3步。制作并提交更改

好样的！现在，您在readme-edits分支的代码视图中，这是一个副本master。我们来做一些编辑。

在GitHub上，保存的更改称为提交。每个提交都有一个关联的提交消息，该消息是解释为何进行特定更改的描述。提交消息可捕获更改的历史记录，因此其他贡献者可以了解您已完成的操作和原因。

制作并提交更改

1. 单击该README.md文件。
2. 点击  pencil icon in the upper right corner of the file view to edit.
3. In the editor, write a bit about yourself.
4. Write a commit message that describes your changes.
5. Click Commit changes button.

These changes will be made to just the README file on your readme-editsbranch, so now this branch contains content that’s different from master.

 

Step 4. Open a Pull Request

Nice edits! Now that you have changes in a branch off of master, you can open a pull request.

Pull Requests are the heart of collaboration on GitHub. When you open a pull request, you’re proposing your changes and requesting that someone review and pull in your contribution and merge them into their branch. Pull requests show diffs, or differences, of the content from both branches. The changes, additions, and subtractions are shown in green and red.

As soon as you make a commit, you can open a pull request and start a discussion, even before the code is finished.

By using GitHub’s @mention system in your pull request message, you can ask for feedback from specific people or teams, whether they’re down the hall or 10 time zones away.

You can even open pull requests in your own repository and merge them yourself. It’s a great way to learn the GitHub flow before working on larger projects.

Open a Pull Request for changes to the README

Click on the image for a larger version

Step	Screenshot
Click the  Pull Request tab, then from the Pull Request page, click the green New pull request button.
In the Example Comparisons box, select the branch you made, readme-edits, to compare with master (the original).
Look over your changes in the diffs on the Compare page, make sure they’re what you want to submit.
When you’re satisfied that these are the changes you want to submit, click the big green Create Pull Requestbutton.
Give your pull request a title and write a brief description of your changes.

When you’re done with your message, click Create pull request!

---

Tip: You can use emoji and drag and drop images and gifs onto comments and Pull Requests.

 

Step 5. Merge your Pull Request

In this final step, it’s time to bring your changes together – merging your readme-edits branch into the master branch.

1. Click the green Merge pull request button to merge the changes into master.
2. Click Confirm merge.
3. Go ahead and delete the branch, since its changes have been incorporated, with the Delete branch button in the purple box.

Celebrate!

By completing this tutorial, you’ve learned to create a project and make a pull request on GitHub!

Here’s what you accomplished in this tutorial:

• Created an open source repository
• Started and managed a new branch
• Changed a file and committed those changes to GitHub
• Opened and merged a Pull Request

Take a look at your GitHub profile and you’ll see your new contribution squares!

To learn more about the power of Pull Requests, we recommend reading the GitHub flow Guide. You might also visit GitHub Explore and get involved in an Open Source project.

---

Tip: Check out our other Guides, YouTube Channel and On-Demand Training for more on how to get started with GitHub.

最后更新于2016年4月7日

GitHub是构建和发布软件的最佳方式。
开源和私有项目的强大协作，代码审查和代码管理。