Github入门helloworld中文教程

Step 1. Create a Repository

 

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

Hello-world存储库可以是一个存储想法、资源，甚至可以与其他人共享和讨论的地方。

To create a new repository

1在右上角，在您的头像或标识图标旁边，单击+，然后选择New repository。

 

2将您的存储库命名为hello-world。

 

3写一个简短的描述。

 

4选择使用自述文件README初始化此存储库。

 

Click Create repository.

Step 2. Create a Branch

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

 

默认情况下，您的存储库有一个名为main的分支，它被认为是最终分支。在将分支提交到main之前，我们使用分支进行实验和编辑。

 

当您在主分支之外创建一个分支时，您正在制作main在当时的副本或快照。如果在您处理分支时其他人对主分支进行了更改，您可以引入这些更新。

 

此图显示：

 

1主要分支

2一个名为feature的新分支（因为我们在这个分支上做“功能工作”）

3功能在合并到主功能之前所经历的旅程

你曾经保存过不同版本的文件吗？比如：

1故事.txt

2故事乔-编辑.txt

3故事乔编辑-已审阅.txt

分支在GitHub存储库中完成类似的目标。

在GitHub，我们的开发人员、作者和设计师使用分支将bug修复和特性工作与主（生产）分支分开。当变更准备就绪时，它们将分支合并到主分支中。

To create a new branch

1转到新的存储库hello-world。

2单击文件列表顶部显示branch:main的下拉列表。

3在“新建分支”文本框中键入分支名称“readme-edits”。

4选择蓝色的创建分支框或按键盘上的“回车”。

 

现在有两个分支，main和readme-edits。他们看起来一模一样，但时间不长！接下来，我们将向新分支添加更改。

Step 3. Make and commit changes

好极了！现在，您在readme-edits分支的代码视图中，该分支是main的副本。让我们做一些编辑。

在GitHub上，保存的更改称为提交（commits）。每个提交都有一个关联的提交消息，这是一个解释为什么要进行特定更改的说明。提交消息会捕获更改的历史记录，这样其他参与者就可以理解您所做的事情以及原因。

Make and commit changes

1单击README.md文件。

2单击文件视图右上角的铅笔图标进行编辑。

3在编辑中，写一些关于你自己的事情。

4编写一个描述更改的提交消息。

5单击“提交更改（Commit changes）”按钮

 

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

 

Step 4. Open a Pull Request

不错的编辑！现在您在main之外的分支中有了更改，您可以打开一个pull request。

 

pull request是GitHub上协作的核心。当你打开一个pull request时，你就是在提议你的变更，并请求某人审查你的贡献，然后把它们合并到他们的分支中。Pull请求显示来自两个分支的内容的差异。更改、加法和减法以绿色和红色显示。

 

一旦提交，就可以打开pull request并开始讨论，甚至在代码完成之前也是如此。

 

通过在pull request消息中使用GitHub的@mention system，您可以请求特定人员或团队的反馈，无论他们在大厅下面还是10个时区之外。

 

您甚至可以在自己的存储库中打开拉取请求并自己合并它们。这是在进行大型项目之前学习GitHub流的一个很好的方法。

Open a Pull Request for changes to the README

 

Step	Screenshot
单击“pull request”选项卡，然后从“pull request”页面单击绿色的“new pull request”按钮。
在“Example comparisons”框中，选择要与mian（原始）进行比较的分支readme-edits。
在比较页面上查看差异中的更改，确保它们是您要提交的内容。
当您对这些更改感到满意时，单击绿色的create pull request按钮	正在上传…重
给pull request一个标题，并写下更改的简要描述。

当你完成消息后，单击Create pull request!

提示：您可以使用emoji并将images和gifs拖放到comments和Pull Requests上.

Step 5. Merge your Pull Request

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

1单击绿色的Merge pull request按钮将更改合并到main中。

2单击“确认合并”。

3继续删除分支，因为它的更改已经被合并，使用紫色框中的delete branch按钮。

Celebrate!

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

以下是您在本教程中完成的工作：

1创建了一个开源存储库

2建立并管理一个新的分支机构

3更改了一个文件并将这些更改提交到GitHub

4打开并合并了一个请求

看看你的GitHub档案，你会看到你的新贡献方格！

 

要进一步了解拉请求的功能，我们建议您阅读GitHub流程指南。您也可以访问GitHub Explore并参与一个开源项目。

 

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