原文地址：The beginner's guide to contributing to a GitHub project

原文作者：Rob Allen

译文出自：掘金翻译计划

本文永久链接：https://github.com/xitu/gold-miner/blob/master/TODO1/the-beginners-guide-to-contributing-to-a-github-project.md

译者：sophia

校对者：maoqyhz Isabella

这是一个针对于如何在 GitHub 上贡献开源代码的新手指南。该指南主要基于我看到 Zend Framework，Slim Framework 和 joind.in 它们如何操作。但是，这仅仅是一个通用的指南，因此请先检查项目的 README 文件以了解具体情况。

第 1 步：在你的计算机上设置工作副本

首先你需要这个项目的本地克隆，所以先在 GitHub 中按下“fork”按钮。按下按钮后会自动在你的 GitHub 账户中创建一个该项目仓库的副本，而且你会看到在已经被 fork 成功的项目名称下面有一行注释：

现在你需要一个本地副本，因此在右侧列中找到“SSH clone URL”，并使用它在本地终端进行克隆：

$ git clone git@github.com:akrabat/zend-validator.git

如下图所示：

转到新项目所在目录中去：

$ cd zend-validator

最后，在这个阶段，你需要设置一个指向原始项目的新远端地址，以便你可以抓取原始项目的任何更改并将它们更新至本地副本。首先定位到原始项目的链接 —— 它在 GitHub 页面的顶部，通过“fork from”标记。该链接会将你带回原始项目的 GitHub 主页，因此你可以在该页面找到“SSH clone URL”，并使用它去创建新的远端，我们称之为 upstream。

$ git remote add upstream git@github.com:zendframework/zend-validator.git

你现在在磁盘上拥两个此项目的远端：

origin：它指向你 fork 的 GitHub 项目。你可以向该远端提交和拉取更新。
upstream：你只能从这个上游的远端拉取代码更新，而无法对其进行修改。

第 2 步：开始做出贡献吧

这是你为项目作出贡献时最有趣的一步。通常情况下，最好从修复一个令人讨厌的 bug 开始，或者是你在项目的 issue 跟踪器中找到的问题。如果你正在寻找一个开始的地方，很多项目使用“easy pick“标签（或者相近意思的标签）来表明这个问题可以由刚刚接触此项目的人来解决。

分支

第一法则是将每一份修改工作都放到自己的分支上。如果项目使用 git-flow，那么它将同时拥有一个 master 和一个 develop 分支。一般的规则是，如果你是修复 bug，那么从 master 上拉下新分支。如果你正在添加一个新功能，那么从 develop 上拉下新分支。如果该项目只有一个 master 分支，直接从该 master 拉取新分支。有一些项目，如 Slim 使用以版本号命名的分支（2.x 和 3.x）。在这种情况下，选择相关的分支。

对于这个例子，我们假设我们正在修复 zend-validator 中的一个 bug，所以我们从 master 拉出新分支：

$ git checkout master
$ git pull upstream master && git push origin master
$ git checkout -b hotfix/readme-update

首先，我们要确保我们在 master 分支上。然后 git pull 命令将我们的本地副本与上游项目同步，并且 git push 命令将它同步到我们所在分支的 GitHub 副本项目中。最后我们创建我们的新分支。你可以根据你的喜好命名你的分支，但是它最好是有意义的。比如分支名中包含 issue 的编号一般很有益处。如果该项目像 zend-validator 一样使用 git-flow，那么在特定的命名约定中分支名的前缀是“hotfix/”或者“feature/”。

现在你就可以开始做你的工作了。

确保你只修复你正在处理的事情。不要试图解决你修复问题过程中看到的其他问题，包括格式问题，因为你的 PR 可能会被拒绝。

确保你在逻辑块中提交。每次提交的备注（commit message）应该清晰说明改动的内容。请阅读 Tim Pope 的关于 Git 提交消息的注意事项。

第 3 步：创建 PR

要创建 PR，你需要将你的分支推送到 origin 远端，然后按下 GitHub 上的一些按钮。

推送一个新分支：

$ git push -u origin hotfix/readme-update

这样做将会在你的 GitHub 项目上创建新分支。-u 标志符表示将本地分支与远端分支相连，以便将来只需输入 git push origin 就可以推送到远端分支。

返回浏览器并导航到你 fork 的项目（在我的示例中地址是：https://github.com/akrabat/zend-validator），你会发现你的新分支在顶部列出了一个简便的“Compare & pull request”按钮：

继续然后按下按钮！

如果你看到这样的黄色框：

点击链接可以将你带到项目的 CONTRIBUTING 文件并且你需要阅读它！它包含有关如何使用该项目代码库的宝贵信息，并将帮助你如何使你的贡献被接受。

在此页面上，确保“base fork”指向正确的仓库和分支。然后确保你为 pull request 提供了一个很好，简洁的标题，并在说明框中解释你为什么创建了它。如果你有相关的 issue 编号，请添加进去。

如果你向下滚动一点，你就会看到你的更改与原版本的差异。仔细检查它是否是你想要的结果。

要是你觉得没什么问题了，按下“Create pull request”按钮即可完成。

第 4 步：由维护人员审查

为了将你的修改工作集成到项目中，维护人员将检查你的修改工作，并请求更改或合并它。

Lorna Mitchell 的文章代码审查：在你运行代码之前涵盖了维护人员将要查找的内容，所以阅读它并确保不给维护人员增添麻烦。

总结

以上就是全部流程了。基础步骤如下：

Fork 原项目并克隆到本地。
创建一个 upstream 远端并在你创建分支之前同步更新到你的本地副本。
为每项单独的工作创建分支。
做好你的工作，编写良好的提交信息，并阅读CONTRIBUTING文件（如果有的话）。
推送到 origin 仓库。
在 GitHub 中创建一个新的 PR。
回应每一条代码审查的反馈信息。

如果你想为一个开源项目做贡献，最好的选择就是你正在使用的某个项目。项目的维护者会很感谢你的！

如果发现译文存在错误或其他需要改进的地方，欢迎到掘金翻译计划对译文进行修改并 PR，也可获得相应奖励积分。文章开头的 本文永久链接 即为本文在 GitHub 上的 MarkDown 链接。

掘金翻译计划是一个翻译优质互联网技术文章的社区，文章来源为掘金上的英文分享文章。内容覆盖 Android、iOS、前端、后端、区块链、产品、设计、人工智能等领域，想要查看更多优质译文请持续关注掘金翻译计划、官方微博、知乎专栏。