克服创建第一个开源贡献的焦虑🦄

探索并找到正确的存储库和问题

首次贡献

从编辑指南中的液体标签中删除了多余的括号 #4500

关注按钮颜色不正确 #4106

编写代码并发送拉取请求

注意：本文面向那些已经知道如何创建拉取请求，但又不敢创建，或者不知道如何准确找到要处理的议题或仓库的人。如果您在创建拉取请求的过程中需要帮助，可以查看Atlassian 的 Git 和 GitHub 指南，或Harsh 的 Git 基础指南。

开源可能会让人不知所措，并且为别人的项目做出贡献一开始可能会看起来很困难。

“如果我把一切都搞砸了怎么办？”、“如果我对代码做了一些愚蠢的事情怎么办？”、“我准备好了……但是这些代码库太庞大了……我该如何找到并修复其中的错误”、“我无法理解代码库……它太大了”。

……这些是我学习 Git 和 GitHub 后遇到的一些问题。虽然我知道如何创建拉取请求，但要么是真的不敢向别人发送拉取请求，要么就是我根本不了解他们的代码库。

希望本文能够帮助您完成此阶段并帮助您创建第一个 Pull 请求。

让我们看看如何找到正确的存储库和问题。

探索并找到正确的存储库和问题

对于初始拉取请求，first-contributions 仓库是一个不错的选择。你需要添加你的名字CONTRIBUTORS.md并发送拉取请求。

作为初步练习，这非常有用。

或者您可以为任何朋友的存储库做出贡献。

即使在对 first-contributions 存储库做出贡献之后，向实际项目发送拉取请求并在存储库中查找问题仍然是一件困难的事情。

你可以从

• 为你使用 或
• 为一些看起来很酷的事情做贡献

- 为您所使用的东西做出贡献。

您可以选择为当前使用的项目做出贡献。您可以列出您正在使用的项目。NPM 包或 Python 包、VSCode 扩展、框架、库，列出您使用的所有东西！

在使用这些项目时，您可能会发现您觉得缺少了某个特定功能，或者特定功能的文档需要更好，或者您在使用时发现了一个错误，甚至是一个拼写错误！

搜索该项目的 GitHub 仓库，并创建一个问题 (Issues)，提及您想要进行的更改。如果您的更改是修复拼写错误或明显的错误，并且不需要您花费太多时间和精力，那么您可以直接创建拉取请求 (Pull Request)。对于功能请求，请务必在开始处理之前创建问题。

例子？

%最近我在阅读 DEV.to 的编辑指南，发现指南中有一个额外的内容，所以我很快做了一个 PR 删除了额外的内容%。

这是我的 PR

从编辑指南中的液体标签中删除了多余的括号 #4500

saurabhdaware 发表于2019年10月19日

这是什么类型的 PR？（勾选所有适用项）

• [ ] 重构
• [ ] 特征
• [x] 错误修复
• [ ] 文档更新

描述

发现液体标签指南中有一个多余的花括号，所以我就把它删掉了

已添加到文档？

• [ ] docs.dev.to
• [ ] 自述文件
• [x] 无需文档

[可选] 哪个 gif 最能描述此 PR 或者它给您带来什么感受？

在 GitHub 上查看

PS：我对这个 Pull Request 感到非常自豪🐨🎉

- 为一些看起来很酷的东西做出贡献。

为你正在使用的东西做贡献并不总是可行的。过了一段时间后，可能很难找到问题，所以你可以直接去你感兴趣的仓库，查看那里的问题。

有些仓库的问题带有“良好首个问题”、“难度：简单”或类似标签。您可以找到这些问题，并评论说“嘿，这看起来很酷！我可以研究一下吗？”。如果您需要任何帮助或更多信息，可以评论此问题并寻求帮助。

另外，不必只浏览“好的第一个问题”，有时其他问题对你来说可能更容易。所以也请浏览一下其他问题，然后选择你感兴趣的那个！

例子？

在Hacktoberfest期间，我随意搜索了一些问题，然后在 DEV.to 上看到了这个关于个人资料主题配色问题。可以看看这里的讨论：

关注按钮颜色不正确 #4106

sierisimo 发表于2019年9月25日

描述错误

阅读文章时，有时按钮的颜色无法清楚地显示其含义。

复制

我在这篇文章中找到了它：https://dev.to/jmfayard/how-kotlin-makes-editing-your-gradle-build-less-frustrating-232l

只是去那里，没有黑暗模式或任何东西，我不确定我是否关注这个特定的用户。

预期行为

带有此用户关注状态的文本应可见或可选

截图

桌面（请填写以下信息）：

• 操作系统：MacOS
• 浏览器：Firefox
• 版本：69.0.1

在 GitHub 上查看

太棒了🎉现在你有一个问题需要解决！开始写代码吧！

编写代码并发送拉取请求

关于大型代码库有一点，没有人知道整个代码库是如何工作的，甚至维护者也不知道！所以你真的不必浏览每一个文件来试图了解每一个功能是如何工作的。

您只需搜索要进行更改的文件。

- 搜索正确的文件

我通常使用屏幕上可见的文本进行搜索，因此如果我想更改 DEV 的导航栏，我会搜索“WRITE A POST”（在桌面导航栏中可见）

以下是搜索结果：

- 本地设置

仓库在 README 或 CONTRIBUTINGmd 中提供本地设置指南。通常，这包括克隆仓库并安装所需的依赖项。

- 编写代码

请务必仔细阅读代码库的贡献指南，了解其中是否有关于编写代码的说明。即使你遗漏了某些内容，维护者也会在你提交 PR 后告知你。仔细阅读贡献指南可以节省你之后修改代码的时间。

- 发送拉取请求

点击“创建拉取请求”按钮！
如果您漏掉了什么，或者修改了错误的功能或文件，这完全没问题（相信我，我经常遇到这种情况）。维护人员稍后会根据需要请求您进行更改。您可以随时提交到分支，更改将反映在拉取请求中。

最后，即使是很小的贡献，在开源项目中也发挥着重要作用，所以在发送 PR 来修复拼写错误时，不要感到尴尬。这是一种公平的贡献，作为一名维护者，这些贡献对我来说非常有用。

每一份贡献都很重要。

感谢您阅读本文。如果您对开源和 GitHub 有任何疑问或需要帮助，可以在评论区留言，或通过我的Twitter @saurabhcodes直接给我发私信。

你也可以在 GitHub 上关注我@saurabhdaware

待在家里，注意安全。🌻