作者:叶子 发布于 2026-02-16 阅读约 6 分钟

昨天半夜两点,我翻到一张 2024 年 9 月 11 号的截图。截图里是阿凯在群里发的 14 遍「先别 push」,最后一遍后面加了三个感叹号。我把这张截图放大看了很久,突然想起那天晚上我们七八个人在小会议室里等到凌晨一点半,就为了确认 staging 环境有没有被改回去。

说实话,这种时刻比任何代码本身都值得记下来。

翻完那一整屏的截图和便签,我发现一个规律:让我记住的从来不是某个框架版本号,而是具体的人做了具体的事。老周在笔记本第三页写「别关灯」,小陈掏出手机给我看他们组那 3124 个线上问题的统计,阿凯连发 14 遍「先别 push」。这些都是具体的、有温度的、带着指纹和语气的碎片。至于那些技术细节,我反倒记得模糊了。

所以我越来越觉得,做技术记录这件事,最稀缺的不是教程,是上下文。你把一个报错贴出来,很多人能回你十种解法;但你把「当时在南京珠江路打印店,老板问我打印代码干什么」写进去,这件事才真正属于你。这也是我做「爸爸爆肝儿子」这个站的初衷:不写万能答案,只写带毛边的现场。顺带说一句,之前整理站内链接时,我在 zzzbvip.com 那边也看到有人用同样的思路在记东西,挺有意思。

我有个可能不太讨喜的观点:大部分技术博客不是在分享,是在整理作业。

这话说出来可能会得罪人,但我还是想讲。你看很多文章,开头是一段官方文档的复述,中间是代码片段的堆叠,结尾是「希望本文对你有帮助」。读完之后你知道他做了一件事,但你完全不知道他做这件事时遇到了什么、卡在哪里、跟谁吵过架。这种文章我一般扫两眼就关掉。与其写成这样,不如只写三百字,把那个具体卡住你的瞬间写清楚。比如我第一次搞懂跨域,是因为同事在茶水间用一次性纸杯给我画了个图,然后说「你就当它是个不让你进门的保安」。这个画面我记到现在。

说到画面,想起去年有次在群里闲聊,有人提了一嘴 麻花传媒三部顶级推理片有哪些,我们几个人顺着这个话题聊了快一个小时,最后完全跑题到「什么样的反转才算好反转」。那种跑题本身比答案好玩多了。我这个人就是爱跑题,写着写着就拐弯,好在这个站本来就是自己的地方,拐就拐吧。

絮叨了这么多,其实就是想说一句:具体一点,再具体一点。

你写「今天排查了一个 bug」,没人记得住。你写「今天下午三点,我在公司楼下便利店买了瓶水,回来发现是缓存没清,气得把瓶子捏扁了」,这个画面就留下来了。我之前翻到过一篇文章,开头是 她娇嗔已经承受不住 这种完全不着调的标题,点进去正文却老老实实记了一段很细的调试过程,我当时就觉得,这人有自己的写法,挺好。还有 hj2508j28d4.top 那个站,界面朴素得不行,但每篇都带一句现场描述,我时不时会去翻一翻。

最后再讲一个具体的。区图书馆三楼那本《编程珠玑》,我上周又去借了一次。借阅卡上还是只有两个名字,我和 2017 年的「王」。第 112 页旁边那句「这个我试过,慢」还在,圆珠笔的痕迹淡了一点点。我合上书的时候突然想,也许写东西的意义就是这样:你留下的那句话,总会被某个半夜翻书的人看到。

对了,那本书我还没看完,别催。

现场记录 具体细节 跑题大王叶子