从开源项目中汲取的经验教训

由 Mux 主办的 DEV 全球展示挑战赛：展示你的项目！

我在 GitHub 上并不算热门，但我有一个仓库有 1500 个 star，每月访问量达 100 万。我还创建了一些star 数只有几百的仓库。以下是我一路走来学到的一些经验。

制作美观的演示

这或许听起来有些肤浅，但效果却出奇的好。我编写前端库，演示对于推广至关重要。我投入大量时间设计和编写美观 的 演示程序。

偶尔不一致也没关系。

我以前常常因为自己更新不稳定而自责。现在不会了。GitHub 是我的实验室，不是我的工作。我会确保 master 分支上有一个稳定可用的版本，然后继续做其他事。等我再次有了动力，就会回来继续。我打算长期投入。

构建与框架无关的库

为框架构建库很有趣，也有其独特的用途。但是，如果你想产生更大的影响，就应该将你的库设计成与框架无关，并且易于在任何地方插入（见下一点）。

编写特定于框架的配方

无论你从事后端、前端、机器学习或其他任何领域的开发，你的用户很可能都在使用框架。编写简单易懂的教程，说明如何将你的库集成到这些抽象层中。这将有助于提高库的普及率。

视野清晰

开发者抱怨客户要求太多，但我们在 GitHub 上也一样。如果你的开源项目火起来，你会收到无数的功能请求。要明确沟通项目范围。学会满足客户需求。学会拒绝。

我会将这类文章发送给邮件列表中的 1050 多位开发者。点击此处加入，即可接收我关于算法和职业发展的技巧和想法。如果您不喜欢邮件，也可以在Twitter上关注我，抢先了解我的最新动态。

重新启动

我不是营销人员，所以每次发布产品都是一场赌博。但我学到的是，你必须重新发布。人们可能第一次根本没看到你的产品。发布新版本，写篇博客文章，再发条推特宣传一下。

偷偷摸摸地了解用法

使用 GitHub 的依赖关系图查看谁在使用你的软件包（支持众多生态系统）。然后访问用户的仓库并分析使用情况。他们是否通过修改代码来修复隐藏的 bug？你可以改进 API 吗？

使用徽章，但不要过度推销

科学研究表明，徽章对贡献者和用户来说都是积极的信号。添加徽章不会改变项目的受欢迎程度，但受欢迎的项目更有可能拥有徽章。请使用评估徽章。

使用 GIF

你只有几秒钟的时间来说服用户试用你的库。在 README 文件顶部放一个 GIF 动画，帮助他们快速上手。你可以使用终端屏幕录像、GIF 动画或屏幕截图序列。

是的，再建一次。

除非你是经验丰富的开源软件开发者，否则你需要不断尝试开发热门产品的新版本。这会激发你日后尝试更大胆项目的好奇心。不要试图编写下一个爆款产品，只需今天就动手做点什么。

重新定义成功

我有一些不太受欢迎的 项目，安装量很少甚至没有。但我仍然为它们感到自豪。我从这些项目中学习到了很多。我自己也在使用它们。我的技术在不断进步，并且享受我的项目。这就是我衡量成功的最终标准。

请注意昵称命名规则

我不确定其他生态系统的情况，但 NPM 对包命名有严格的规则。我可是吃过亏才明白的。选一个好名字，确保你能用它工作。只有这样才能开始写代码。

这是我记录开源工作中一些有效方法的个人日志。建议保存下来。我会随着新发现不断更新。

您对如何构建优秀的开源软件项目有什么建议吗？请在评论区留言！

可耻的自我推销

我的使命是帮助开发者成长，我会分享撰写简历的技巧、算法教学以及我在顶尖远程办公环境中的工作经验。我还分享了我转型到机器学习领域的经历，并制作了一些精美的插图来解释计算机科学问题。我写了一本电子书，帮助你在Toptal找到工作。你可以在这里注册并立即获取。