文/一个靠看Hello World选技术栈的人
上个月我给团队做一个技术选型的调研，需要在三个API网关之间选一个。我把三个官网同时打开，任务只有一个：按照官方文档的”快速开始”步骤，跑通一个能返回”Hello, World!”的接口。
第一个网关，文档第一步”用Helm安装到Kubernetes集群”。我还没建K8s环境，直接劝退。
第二个网关，给了Docker命令，但里面挂载了三个配置文件，每个配置文件的格式还不一样。我折腾了四十分钟，总算跑起来了。但跑起来之后我满脑子都是”这个太复杂了”。
第三个网关，直接给了一行curl命令，下载一个单文件二进制，运行，然后访问localhost:8080/hello就看到了”Hello, World!”。前后三分钟。
最后选了第三个。不是因为它的性能数据最好，不是因为它的社区最大，就是因为”三分钟能跑起来”这件事，在我这里加的分太多了。
后来我跟同行聊这个事，大家都有同感。技术选型的时候，第一个”Hello World”的体验，往往比什么性能测试、功能对比都重要。 你文档写得再好、功能再强大，如果我在前三分钟就卡住了，我大概率不会继续往下看了。这个世界上的选择太多了，没人愿意花一下午去伺候一个刚见面的工具。
开源项目的star数，藏在它的Hello World里
你去GitHub上看那些特别火的开源项目，它们有一个共同的特点——”快速开始”那一节都写得特别好。
Docker的”Hello World”是一行命令，任何装了Docker的人都能在十秒内跑起来。React的”Hello World”是一段代码，复制到HTML文件里双击就能看到页面。Python的Flask框架，官方示例只有七行，跑起来之后访问本地端口就看到”Hello, World!”。
而有些项目，技术可能非常牛，但快速开始部分写得跟天书一样。要装五个依赖、配三个环境变量、修改两个配置文件、再运行一个脚本。然后你照着做了，报错，去搜issue，发现别人也卡在这个问题上，作者说”这个我们下个版本修”——但你连当前版本都没跑起来，怎么到下一个版本？
我关注过一个数据可视化库，底层技术很厉害，star数却始终上不去。我看了它的issue列表，前十条里有七条都是”能不能把快速开始的步骤简化一下”。作者回复说”我们的库就是设计给专业人士用的，不是给小白玩的”。后来这个库逐渐被另一个上手更简单的竞品超过了。
不是技术输了，是”第一印象”输了。
内部工具也一样：你让新人折腾多久，他就对你有多深的怨念
大厂内部都有各种自研平台——部署平台、配置中心、日志系统、监控面板。新人入职的第一周，有一半的时间是在跟这些平台”打招呼”。
我见过的最极端的例子，是一个公司的内部RPC框架。新人入职之后，要装JDK、装Maven、拉代码、配置公司内网的Maven仓库地址、申请各种权限、下载一个特定版本的IDE插件、然后才能开始写第一个”Hello, World”级别的RPC服务。整个过程快的人一天，慢的人三天。
那三天里新人什么业务都没做，就是跟环境搏斗。等他终于调通了一个接口、看到一个”Hello, World”从另外一台机器返回的时候，他对这个框架已经没有好感了。即使它后面再好用，他也永远记得那个”痛苦的初见”。
后来那个框架的团队换了一个负责人。新负责人上任的第一件事就是做了一个”一键启动”的Docker镜像，任何新人在拿到镜像之后十分钟内就能在本地跑起来一个demo服务。他说了一句话我记到现在：”你让开发者前十分钟的体验越好，他后面容忍你坑的能力就越强。 “
这是大实话。所有的软件都是如此——如果你刚认识它就觉得累，那它后面做得再好，你也带着偏见。反过来，如果它上来就给你一个”三分钟成就感”，那后面即使有点小问题，你也愿意帮它想办法。
什么样的Hello World体验才算好
这些年我总结了五个原则，可以用来判断一个软件”第一印象”好不好。
第一，最少依赖。 好的Hello World不需要你装五个组件才能跑。一个语言运行时、一个包管理工具，顶多再加一个数据库——不能再多了。如果它的入门示例就要你装Docker、装kubectl、装helm、装一大堆插件，那它不是给初学者准备的。
第二，复制即可运行。 文档里的代码块应该可以直接复制粘贴到终端或者编辑器里，不用改任何配置就能跑。那种”把代码复制下来之后还要改改成你的appKey和secret”的示例，本质上是个半成品。
第三，反馈要快。 从你开始执行到看到”Hello, World!”，超过三分钟就算慢了。人的注意力就那么长，你让他在等待下载、等待编译、等待启动的过程中消耗掉耐心，他很可能就不等了。
第四，失败信息要友好。 如果跑不通，报错信息要清晰。告诉你缺什么、去哪里找、怎么改。那种”Error: something went wrong”然后什么都没有的，等于没报错。
第五，有一个”成功了”的明确信号。 屏幕上的那行”Hello, World!”就是最好的信号。它清晰、无歧义、让你知道”这条路通了”。不要用那种需要你额外验证才知道”哦可能成功了吧”的模糊方式。
那个让你记住的”Hello World”时刻
我后来回想自己用过的大大小小几十个工具、框架、平台，每一个让我最终留下来的，都有一个”三分钟跑通”的瞬间。
Go语言我第一次接触的时候，官方文档给了一个例子，我复制下来保存成.go文件，go run一下，输出。前后两分钟。然后我决定学Go。
某个消息队列我第一次用的时候，官方给了docker run命令，启动之后用curl发了一条消息，控制台输出”Hello, World!”。前后三分钟。然后这个队列在我项目里用了四年。
而有些工具，我卡在安装上超过半小时就直接关掉了，再也没有打开过。它们技术怎么样？我不知道。因为我没有成功跟它们打过招呼。
所以，给你的项目一个体面的”开场白”
如果你在维护一个软件项目、一个框架、一个平台、甚至只是一个内部工具，我建议你做一件事：
找一个完全不了解你这个项目的人，让他照着你的文档跑一遍”Hello World”。你坐在旁边看，但不要说话，不要帮他。记录下他卡在哪里、问了什么问题、花了多长时间。
然后根据这份记录，去改你的文档、改你的默认配置、加必要的检查脚本。改完之后再换一个人测一遍。直到你找到的那个人能在三分钟内不用任何帮助就输出那行字。
到那个时候，你就给了你的项目一个体面的”开场白”。每一个新用户走进来的时候，都会被这个友好的”你好”留住，然后愿意继续往里走。
因为世界上的软件太多了，用户没有义务陪你折腾。你做的每一个项目，都只有一次机会给别人留下那个”三分钟的第一印象”。
别浪费它。