喝咖啡休息#43。阻碍您获得梦想工作的 6 个编程错误。如何首次为开源软件做出贡献

阻碍你获得梦想工作的 6 个编程错误

来源：Medium 要找到程序员的工作，您需要有一个 Git 存储库。这是招聘人员首先会考虑的事情之一。为了让您的存储库给人留下积极的印象，它应该包含最近更改的项目。只展示您引以为傲的项目，而不是您曾经编写的每一行代码。这是使用存储库的基础知识。请记住，迟早有人会查看您的代码，看看您是否适合该公司。这对你来说将是一个决定性的时刻。几分钟后，招聘人员将决定是否邀请您参加面试。这里有好消息也有坏消息。坏消息是，一个简单的错误就会损害你获得这份工作的机会。好消息是人们通常不想深入研究代码。他们需要对您的代码和架构有一个总体了解。所以你不必是天才——你只需要成为一名优秀的程序员即可。以下是新手常犯的一些错误。避免它们，你的面试机会将会大大增加。

过时的评论

程序员对于注释有不同的看法。有些人喜欢他们，有些人讨厌他们。关于是否值得对代码进行注释以及在什么情况下进行注释，我们无法得出共同的结论。但每个人都一致同意一件事：如果您有注释，它们应该与您的代码相匹配。存在注释来解释代码。当您的代码复杂或不清楚时，您需要帮助读者理解它。另外，当你更改代码时，你需要更改你的注释。如果您不这样做，您的评论将不再有用。一个不好的评论比没有评论更糟糕。更糟糕的是，代码中的注释被突出显示。现代 IDE 以不同的颜色突出显示注释，使其更易于阅读。通过添加注释，您将在代码中放置一个“读我”标志。这样，注释和代码之间的任何差异都将很容易被发现。明智地选择您的评论，并记住将它们与您的代码一起更新。这样他们就会很好地为您服务。

具有相同用例的库和语言的组合

在第一次面试之前，我必须解决一个招聘问题。这是一个简单的网络应用程序，所以我编写了一些代码，用谷歌搜索了一些复杂的问题，然后应用程序就准备好了。在面试过程中，招聘人员问我为什么在整个代码中混合使用 jQuery 代码和纯 JavaScript。我的答案？“嗯……”老实说，我粘贴了 Stack Overflow 上的一些代码片段。我没有想太多。该代码有效，所以我继续前进。这个错误在新开发人员中很常见。我们过于专注于解决工作中的问题，却没有注意我们是如何做到的。不要成为落入这个陷阱的新手之一。检查每一行代码并确保您知道为什么将其放在那里。

代码重复

不要重复自己（DRY）是一个编程教条。为重复代码创建抽象是编程的本质。是的，一开始可能会很困难。当你想解决一个问题时，你会以任何可能的方式去做。然后你继续执行其他任务，重复的代码就会留在你身边。你可以通过为自己制定一套规则来改掉这个习惯。每次改进功能时，请再次阅读代码，看看是否可以做任何更改。请记住，代码的第一个版本通常是错误的，您可以改进它。当您发现重复的代码时，请花时间研究它。这样您就可以找出重写它的最佳方法（例如，使用循环或创建新函数）。如果你每次都进行这样的清理，你最终会得到更可靠和优雅的代码。

未处理的错误

创建任何始终完美运行的有意义的应用程序几乎是不可能的。无论您是填充数据库还是进行 API 调用，都会发生错误。未处理的错误不仅会阻止单个函数运行，甚至可能导致整个应用程序崩溃。预测可能出现的错误是一个有能力的程序员的标志。每当您访问或更新任何外部数据时，您都需要为最坏的情况做好准备。以不会使应用程序变得笨拙的方式标记潜在问题。这将使代码的读者（也许还有您）能够快速找到错误。它还将向招聘人员表明您可以编写有凝聚力的代码。

缺乏一致性

一致性是高质量软件的标志。它使代码更易于阅读和维护。以统一风格创建的代码更可预测，并且更容易评估程序的性能。在更高的抽象层次上，一致性是很难实现的。掌握它需要数年时间，因此您需要尽早开始学习这项技术。请记住仅使用一种语言创建标题。它可能应该是英语，但在个人项目中，您可以用任何语言命名变量和函数，只要它始终是相同的语言即可。如果你保持一致，那么使用制表符或空格都没有关系。创建或选择风格指南并始终坚持下去。您还应该使用像Prettier这样的工具。它确实有助于以一致的方式保持代码格式。无论您使用什么工具和风格，请始终如一地使用它们。即使您以一致的风格编写了糟糕的代码，它通常也比不一致的好代码要好，因为它更容易修复。

对工具的误解

在典型的项目中，您可能必须使用一些外部库。许多程序员几乎自动安装库，因为它们在每个项目中都会使用。外部库很棒，因为它们是解决重复出现问题的行之有效的方法。然而，新开发人员通常不了解他们正在使用哪些库，最终会在另一个库之上添加一个库或重新实现一些现有功能。每次在项目中安装库时，请阅读或至少查看文档。检查您可以使用的方法和属性，并确保您了解库应该解决哪些问题以及需要使用不同的工具。这样您就可以为工作选择正确的工具并解释您的选择。

如何首次为开源软件做出贡献

来源：Jamestucker.dev 有一天，我看到 Evan Yu（Vue.js的创建者）发布的一条关于他正在开发的新存储库的推文，这引起了我的兴趣。我决定我要为此做出贡献！问题是我以前从未为开源项目做出过贡献，也不知道从哪里开始。但这不可能那么困难，对吧？当我进入存储库时，我立即愣住了。“我到底该怎么办？”我心里想。如果我提出 PR（拉取请求、合并请求），专家可能会将我的代码撕成碎片。在开发界，我永远被认为是一个不知道如何正确使用开源的人。我的职业生涯也将结束。幸运的是，我读过一篇文章（我不记得在哪里），作者建议您对其他人存储库的第一次贡献应该尽可能谨慎。这可能就像纠正拼写错误一样简单。我也这么做了。我阅读了存储库文档，发现了一些拼写错误，打开了 PR，然后你瞧，Evan 批准了我的更改。我正式成为 Vue 贡献者！也许我应该把这个放在我的 Twitter 简介中？

“那太好了，但是我该如何开始呢？”

好的，让我们开始吧：我将向您展示可以采取哪些步骤来发挥作用。

1. 寻找项目

为了获得灵感，请考虑您最喜欢的技术或工具。假设您使用 JavaScript 并经常使用Gatsby？查看他们的存储库！您还可以为我的存储库之一做出贡献。这是我的前端项目的列表。如果您有喜欢或觉得有用的东西，我很乐意您添加它！最后，Awesome First PR Opportunities是一个面向初学者的开源项目的巨大存储库。有 22 种不同语言的项目！

2. 决定如何做出贡献

查看该项目。阅读自述文件。扫描不同的文件夹和文件。了解代码库的结构。通过这样做，您可以轻松找到并纠正拼写错误！完成此操作后，请查看项目的“问题”部分。在那里您将找到以前发现的错误或建议功能的列表。幸运的是，许多项目都涉及针对初学者的问题。我认为你的第一个贡献应该尽可能微妙，但如果你想快速获得认可，这取决于你。一旦找到可以添加到项目中的内容，您将需要分叉它。

3. 创建项目的fork

分叉（项目的分叉）会在您自己的 Github 存储库中创建它的精确副本。

4. 将项目克隆到本地

然后使用项目 URL 将项目克隆到本地文件夹。

git clone <project-url>

在这里您可以找到 URL。现在该项目已位于您的计算机上，请在编辑器中将其打开。如果您认为更改需要时间，请务必将项目副本与原始项目同步，以便您始终了解更改。您可以在此处找到具体的 Git 命令。

5. 为您的更改创建一个新分支

是时候进行更改/更正了！创建一个新分支，您的更改将在其中生效。

git branch <branch-name>

您可以随意命名它，但根据我的经验，您将能够看到原始项目中命名分支的模式。在这种情况下，我建议遵循现有模板。修复拼写错误的一个好的分支名称是patch/typo-fix。您可以使用git checkout <branch-name>切换到此分支。现在就做出改变吧！

6. 提交 PR（合并请求）

您已经修复了明显的拼写错误或更新了损坏的链接。你对自己的工作感到自豪。您希望全世界都知道您是神话般的开发人员之一，可以同时编码、擦除和观看 Netflix。使用git push -u origin <branch-name>将更改推送到分支 Github 存储库 。转到您分叉的 Github 存储库并打开 PR（拉取请求）。注意：如果您以前从未做过拉取请求，请观看 Kent Dodds 的这段视频以了解如何操作。确保您的分支指向源存储库的 master 分支。现在您已准备好向您的 PR 添加详细信息。确保您的标题清楚地传达了公关的内容。添加描述：如果您要解决现有问题，请务必包含指向该问题的链接。完成描述后，提交您的 PR 供审核。有权批准 PR 的人可能会在几天内审核您的申请并执行以下操作之一：

1. 将立即合并更改。
2. 它会要求您进行更改。
3. 将关闭您的 PR。

请耐心等待，因为存储库创建者可能正忙于全职工作或其他项目。

你做到了！

您现在是开源项目的贡献者！感觉如何？准备好构建自己的 Node.js 竞争对手了吗？我希望通过做出简单的贡献，未来开源工作的前景将变得不那么令人畏惧。有关开源贡献的更多信息，请查看开源指南。