GitHub通过构建第一个真正的社交编码网站IMHO，彻底改变了开源世界。 无论是简单地讨论一些新功能，提交错误还是在最佳情况下提交错误修复或新功能补丁： 拉取请求（PR） ，对项目做出贡献从未如此简单。 不过，我发现很多开发人员还不知道如何正确创建PR。 我希望通过本文可以降低这种进入障碍。

OSS提示：如果您希望更快地修复错误，请提交测试失败的PR，而不是问题。

— Sindre Sorhus（@sindresorhus） 2015年3月21日

首先…学习git

Git是使用最广泛的版本控制系统，尤其是对于开源项目。 虽然您也可以在GitHub上使用SVN，但大多数项目都不使用。 仅仅是因为Git更适合于分布式工作的用例，来自世界各地的多个人克隆，派生并将新更改提交到您的存储库。

也就是说，您必须了解Git的基础知识并习惯它的工作方式。 因此，您应该了解...

• 取，拉和推
• 查看
• 校长
• 状态
• 添加并提交
• 还原和撤消更改
• 分支与合并
• 重新设定
• 遥控器

我强烈建议您花些时间研究这些内容，习惯它们，并使用一些本地演示资源库在其中进行尝试（不破坏任何内容）。 相信我，这将为您省去很多麻烦和痛苦。

本文可能会帮助您入门： Git解释：适用于初学者

创建一个GitHub帐户

每个认真的开发者都需要一个。 不完全是！ 转到https://github.com ，创建一个并将其链接到本地​​Git shell 。

我应该如何进行？

搜索其他人是否已经提议或已提交修复程序。 GitHub有一个简单但出色的问题跟踪系统。

如果是错误，请创建失败的测试，然后尝试在本地重现。 好的存储库已经具有良好的测试工具。 然后，将您的修订提交为PR（包括验证其是否存在的测试）。

如果这是一项新功能建议，我个人建议与作者联系。 提出问题并提出增强功能和新功能。 这样，您可以从作者或核心撰稿人那里获得更多见解，尤其是避免走错方向。 提交未合并的新代码很麻烦，因为作者对此有所不同。 相信我！ 。

查看README.md和参考指南

绝对检查README.md，它以良好的可读性自动呈现在GitHub存储库的根目录下。 许多回购协议都包含构建存储库的说明，尤其是有关贡献，构建等的指导！

因此，验证是否有

• 需要对新更改进行自动化测试的准则（即使没有明确要求，这始终是一个好主意）
• 提交消息准则（例如： angular.js ， atom.io ）。
• 编码规则
• …

好的，准备开始！

现在是时候整理一下Git Jedi的花样了。

步骤1：分叉仓库

第一步是分叉您想贡献的仓库。 GitHub为您做到了，只需搜索分叉按钮即可：

这将在您自己的GitHub用户个人资料下自动创建存储库的副本。

第2步：克隆您的分叉存储库

现在您已经在自己的GitHub用户个人资料中拥有一个副本，您具有完全的读/写访问权限，并且可以将更改/功能实现应用于代码库了。 克隆叉子并开始编码。

在这一点上，我们必须谈论“ git flow”。 当使用git时，此术语包括一些策略和良好实践。 以下是一些有用的文章：

• 了解GitHub流程
• 实施“ Git流” 。

如果您现在不想深入了解它，请至少为您的更改创建一个功能分支 。 强烈建议这样做。

$ git checkout -b my-new-feature

现在该进行编码了：实现您的更改。

步骤3：完善您的历史记录，压缩不必要的提交

通常，当您进行开发时，您可能会有很多提交，甚至是中间的提交，这些提交消息可能只有您自己才能理解（即使...。！）。

使用git rebase可以完善您的历史记录，仅包含相关的历史记录，并帮助作者更轻松地查看您的更改。 这样做的方法： 抛光功能分支commits 。

步骤4：将其推送到您的分叉存储库

现在，将分支推送到您的仓库：

$ git push --set-upstream origin my-new-feature

步骤5：提交您的PR

将分支推送到仓库后，只需在GitHub上打开它即可。 应出现突出显示的消息，邀请您创建PR。

单击“比较并提取请求”按钮，然后填写详细信息。

Wohooo，您做到了！ 您的PR已完成！

GitHub上还有一个很好的指南 。

顺便说一句，您可以简单地将其他提交推送到分叉存储库的功能分支，它们将自动出现在PR中。

与原始仓库链接/同步

如果您的贡献是一次性的错误修正，则合并后的存储库也可以删除。 相反，如果您打算做出进一步的更改，则可能需要设置指向原始存储库的链接，您可以不时更新自己的存储库主数据库。

这是通过添加另一个指向原始GitHub存储库的git remote来完成的

$ git remote add upstream   <the repo url>

一旦有了它，就可以通过执行同步

$ git checkout master
$ git pull upstream master

或先进行git fetch ，再进行git merge （基于您的偏好）。

这是GitHub帮助页面上的文章，也可能会有所帮助 。

结论

贡献对于保持开源生态系统的生命至关重要，在这样做的同时您会学到很多东西！ 同时，要尊重作者的指导方针，要有礼貌，并使用表情符号，这是有充分理由的！ （这可能很有用）

翻译自: https://www.javacodegeeks.com/2015/06/github-be-social-contribute-learn.html