技术随笔

从「记了等于会了」到「记了真的能省时间」,中间隔了大概三百篇笔记。这篇聊几个被实践证明有效的转变。

从「教程体」改成「排查体」

一开始写笔记,总想着从概念讲起、面面俱到。结果是写的时候很累,用的时候找不到。

后来改成以问题开头:

现象:df 显示磁盘 100%,但 du 只有一半。
原因:文件被删除但进程仍持有句柄。
解法:lsof | grep deleted 找到进程,发信号让它重开日志。

同样的知识量,检索时快得多——因为我记得住「现象」,记不住「第几章第几节」。

只记「我验证过的」

以前会把搜到的答案直接贴进去。后来发现,那些没亲手跑过的东西,记了反而有害:下次照着做,出错时更迷惑。

现在的规则是:没在自己机器上跑通的内容,只留链接,不放步骤。

加一行「什么情况下不适用」

大多数教程的失败点不在主流程,而在边界条件。比如「用 mysqldump 备份」这条建议,在几十 GB 的库上就会变成灾难。

所以现在每篇笔记结尾都留一句适用范围的说明。写的时候多花一分钟,用的时候少踩一次坑。

固定一个「回头看」的时间

写完当天不整理。等一周后再读一遍,能删掉三成内容——那些当时觉得重要、实际没用的铺垫。

留下来的通常是最短、最直接的部分。

小结

这几个习惯的共同点是:都让笔记变短了。短不是目的,但它是「真正被用起来」的一个不错指标。

参与讨论