Linus亲述：不写文档，如何用云原生思维带出千万开源开发者

　　去年中考那会儿，运维群里突然炸了——GitLab的慢查询报警跟疯了似的刷屏，我盯着屏幕上的行数从三位数跳到五位数，风扇在脚下转得像要起飞。开发小王冲过来拍桌子：“这破索引又崩了？上次不是刚调过？”我原以为又是哪个SQL没走索引，结果翻日志才发现，是某个冷门分支的查询条件突然被改成了模糊匹配，直接扫了全表。这时候群里有人甩了个Linus的访谈链接，标题是“不写文档，如何用云原生思维带出千万开源开发者”，我差点把咖啡喷键盘上——这特么不是我们上周刚吵过的话题吗？

　　Linus那套“优胜劣汰”的逻辑，说白了就是“能用就行，烂了自然有人修”。我第一反应是扯淡——上周刚有个核心服务因为没文档，新来的运维误删了主从同步的配置，数据丢了俩小时才恢复，领导差点把监控室的天花板掀了。但仔细想想，GitLab那事儿还真有点道理：小王的慢查询报警响了半小时，群里没人喊“我修”，倒是有人甩了个PR链接，说“我改了个更快的查询，你们看看能不能用”。三小时后，报警自己停了——新代码被自动合并了。我盯着屏幕发愣：这不就是Linus说的“让代码自己说话”吗？

　　那天中午外卖凉了都没吃，我一直在翻GitLab的提交记录。发现个有意思的事：他们最近半年的PR里，超过六成是“修复性能问题”或“优化查询”，但文档相关的提交几乎为零。有个开发者在评论里说：“谁有空写文档？有这时间我早把慢查询杀了。”我原以为这是扯淡，结果翻到Linus的原话：“文档会过期，代码不会。如果代码难用，自然有人来改；如果没人改，说明它不重要。”窗外天黑了，运维小李路过问了句“好了没”，我指着屏幕上的提交记录：“你看，这不就是云原生的‘自愈’吗？”

　　但问题来了：这种“自愈”真的靠谱吗？上周我们有个服务因为没文档，新来的开发把事务嵌套了三层，导致数据库锁表半小时。领导拍着桌子骂：“你们就不能写点文档？”我翻出GitLab的例子：“人家Linus说，烂代码活不过三个版本。”领导冷笑：“那要是活过了呢？”我哑口无言——确实，有些烂代码就像打不死的小强，改一次又冒出来，最后大家只能绕着走。这时候群里有人甩了张截图：GitLab的某个核心服务，最近三个月的慢查询数量从每天上百条降到了个位数，但文档还是那几行“TODO”。

　　跟开发吵了一架后，我偷偷去问了个搞开源的朋友。他说：“Linus那套在Linux内核行得通，因为参与者都是老鸟，烂代码根本活不过提交。但你们这种企业级服务，新人多，烂代码能活到上线。”我反驳：“那GitLab怎么行？”他笑了：“GitLab的‘优胜劣汰’是靠社区驱动的——烂代码会被骂，被PR轰炸，被自动测试卡住。你们呢？新人敢随便改代码吗？敢不写文档吗？”我愣住了——我们确实不敢，改个配置都要层层审批，写文档是KPI，改代码是冒险。

　　那天晚上我翻到Linus的另一段访谈，他说：“云原生的核心不是技术，是文化。你得让开发者觉得，改代码比写文档更安全，更有效。”我盯着这句话看了半小时，突然想起上周的慢查询事件：小王提交的PR被自动测试卡了三次，最后他直接在评论里贴了性能对比图，说“不服来测”，结果没人反对，PR直接合并。这不就是“文化”在起作用吗？文档？谁有空看啊，大家都盯着代码和测试结果。

　　但我还是有点慌——万一哪天遇到个真的难搞的烂代码，没人修怎么办？朋友说：“那说明它不重要，或者你们该换架构了。”我原以为他在扯淡，结果翻GitLab的提交记录，发现他们确实会定期删除“三个月没人用”的代码，连文档都不留。我问：“那数据丢了怎么办？”他说：“云原生时代，数据可以重建，代码不能烂。”我突然想起上周误删数据的事——如果我们当时有自动备份和快速恢复，或许就不用那么慌了。

文章配图，仅供参考

　　下一步我打算试试：把一些非核心服务的文档删了，逼着开发者看代码和测试结果。如果效果不好，再回来写文档——反正现在备份策略挺完善，数据丢了也能快速恢复。至于Linus那套到底行不行，我也不知道，但至少，GitLab用行动证明了，它不是完全扯淡。风扇还在转，屏幕上的行数还在跳，但这次，我没那么慌了。

（编辑：站长网）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!