介绍

Hacktoberfest 是为期一个月的开源软件庆祝活动，由 DigitalOcean 运营并向我们全球社区的所有人开放。要参与，您需要在 10 月份向公共 GitHub 存储库提交四个质量拉取请求。完成挑战后，您将获得特别奖品，包括一件独家 Hacktoberfest T 恤。

您可以在 10 月 1 日至 10 月 31 日之间的任何时间注册，我们鼓励您与其他开发人员和 Hacktoberfest 爱好者联系，参加从 9 月开始的虚拟活动和信息会议。

在本教程中，我们将向您介绍 Git（您将用于提交拉取请求的版本控制系统）和 GitHub（我们将用于跟踪您的进度的存储库托管服务）。在本教程结束时，您将准备好提交您的第一个拉取请求，并且将顺利参加 Hacktoberfest！

版本控制

在我们开始 Git 和 GitHub 之前，让我们先谈谈版本控制。当开发人员一起处理一个项目时，他们通常需要在相同的代码库上工作。在他们工作时，每个开发人员都需要了解其他开发人员所做的更改，以免重复工作或在已经完成的工作上编写代码。

版本控制系统用作代码的保存程序，它为项目分配一个版本并跟踪随着时间的推移对项目中每个文件所做的更改。通过这种方式，开发人员可以通过签入最新版本来共同处理项目，以便在处理他们的项目代码部分之前查看所做的更改。

Git 和 GitHub

Git 是一种用于管理各种规模的开发人员项目的版本控制系统，由 Linux 的创建者 Linus Torvalds 于 2005 年创建，旨在帮助开发人员以快速、高效且廉价的方式贡献代码和共享代码修订版。Git 使开发人员能够编辑、共享和发布代码，促进协作和团队合作。

GitHub 是一种基于云的 git 存储库托管服务，允许开发人员获取他们在本地机器上编写的代码并与全世界共享。它提供了一种通过存储库或中央文件存储位置公开共享本地计算机上的版本跟踪项目的方法，并且根据项目的可用性（它可以是公共或私有存储库），其他开发人员可以将项目下载到编辑代码、提供见解等。

要开始使用 GitHub，您可以在GitHub 上创建一个帐户。有关如何执行此操作的更多详细信息，请参阅Hacktoberfest 资源页面。

克隆存储库

我们现在将克隆和编辑我们的第一个 GitHub 存储库。首先，让我们导航到我们想要克隆的存储库。在本教程中，我们将使用Cloud Haiku 存储库。

在克隆此存储库之前，即将 GitHub 上的代码副本复制到您的本地计算机上之前，您需要将整个存储库的副本复制到您自己的 GitHub 帐户中。这称为存储库的分支，它允许您在不影响主代码库的情况下开发代码。

要分叉存储库，请单击存储库右上角的Fork按钮。要克隆，请单击 code按钮，复制提供的链接，然后观察 GitHub 获取此存储库并将其作为副本添加到您的帐户。您的名字现在应该显示为这个存储库的创建者，它是主俳库存储库的“分支”。

接下来，导航到您的命令行界面以在本地计算机上克隆项目。您可以使用该git clone命令来执行此操作，该命令将克隆或复制我刚刚从 haiku 存储库创建的 fork 到我的本地计算机。这将使您能够在本地（在您自己的机器上）更改代码库。

cd ~
git clone https://github.com/sammy/cloud_haiku

编辑代码内容

您现在在本地计算机上拥有 Cloud Haiku 存储库的副本，因此您已准备好准备您的贡献。使用命令行界面，导航到克隆存储库的文件夹。如果您按照以下步骤操作，您cloud_haiku的主目录中应该有一个文件夹：

cd ~/cloud_haiku

有许多文本编辑器和集成开发环境 (IDE) 可用于编辑代码。IDE 通常按编程语言进行细分，并包含一系列有用的功能，以简化使用该语言开发应用程序的过程。如果您的工作机器中当前没有设置 IDE，请考虑查看Hacktoberfest 的资源页面以获取有关如何选择 IDE 的建议。

花时间阅读和理解项目的组织方式和贡献指南，并找到您可以处理的代码部分，这一点很重要。在进行更改之前，请阅读提供的任何相关文档。接下来，让我们提交俳句！

将内容添加到远程存储库

现在我们对俳句存储库进行了更改，我们需要跟踪并保存该更改。跟踪更改的第一步是将其添加到您正在处理的版本中。为此，我们将执行命令git add .：

git add .

以这种方式编写命令允许您跨文件添加对存储库所做的所有更改。如果您只需要提交对单个文件的更改，请使用：git add filename

git add sammyhaiku.md

运行该add命令后，您将不会得到任何确认。要查看您的更改是否已包含在准备提交的文件列表中，您可以执行以下命令git status：

git status

这允许您检查跟踪更改的状态 – 您将看到您的文件已添加，但未作为更改提交。如果您需要在将更改正式跟踪为新代码或已编辑代码之前对其进行修改，Git 会提供此步骤。

接下来，让我们提交我们的更改。执行命令git commit，并添加一条消息，以便在此项目上协作的其他开发人员将了解您所做的更改：

git commit -m "added sammy haiku"

使用消息编写提交允许开发人员了解所做的更改——此消息与提交 ID 和您的用户名一起被跟踪。

提交后，我们需要将push本地机器更改为 GitHub 上的远程存储库。为此，让我们执行以下命令git push：

git push

在这里，我们可以为推送指定一个来源——在这种情况下，我们希望我们的贡献转到我们的 DigitalOcean 俳句存储库的分叉版本。

回顾一下，到目前为止，我们已经确定了一个我们想要编辑的存储库，并使用fork和将存储库的副本复制到我们的 GitHub 帐户和本地机器中clone。我们进行了更改，并使用 提交了我们的更改git add。然后我们通过运行 来巩固我们的更改git commit，它提交了更改。git push将我们的更改从本地机器推送到 GitHub 上的远程存储库。如果我们查看 GitHub，我们会看到我们所做的更改反映在我们俳句存储库副本中的文件中。

创建拉取请求

我们现在准备让项目的维护者知道我们对存储库进行了更改，我们有信心并准备提交。为此，我们将单击右侧的拉取请求按钮。

单击拉取请求按钮后，将打开一个新页面，其中包含一个表单，解释我们所做的更改，并显示所做的更改是否会以任何方式与现有内容冲突。我们将添加一个适当的标题来详细说明更改，并在描述中添加对所做更改及其原因的解释。您在此处添加的内容可能因项目而异 – 查看项目的协作指南以确保您的拉取请求格式正确。

在添加更改的标题和描述后，我们将扫描拉取请求页面以确保我们提交的更改与对代码存储库所做的现有更改不冲突。如果一切顺利，我们将在底部看到一个绿色的提交拉取请求按钮，该按钮会升级我们对原始俳句代码库进行更改的请求，该贡献将对查看该主分支的任何人生效。要有耐心——维护人员可能需要一些时间来审查您的请求。可以在拉取请求页面上添加修改和评论，对相同受影响文件的新提交将出现在请求的历史记录中。

恭喜 – 我们已经成功提交了我们的第一个拉取请求！

结论

在本教程中，您了解了 Git 和 GitHub，并成功识别并将更改提交到公共存储库。对于 Hacktoberfest，您需要提交 4 个有意义的拉取请求，因此再次找到与您产生共鸣的项目并享受黑客攻击！

要查看本教程的实际效果，这里有一个有用的视频，可引导您完成提交第一个拉取请求的过程：

有关 Hacktoberfest 的更多信息，请访问我们的主页。

要了解有关 Git 的更多信息，请访问如何使用 Git：参考指南。

有关 GitHub 的其他信息，请访问GitHub。