很多问题并不是第一次遇到。真正耗时间的，往往是：当时怎么解的已经忘了，关键词也想不起来，只能再搜一遍、再试一遍。

所以我给自己定了一个很轻的规则：只要排错超过二十分钟，就写一段短记录。

记什么就够了

不追求「教程体」，只保留以后能快速复用的信息：

  • 现象：报错原文、页面表现、复现步骤
  • 环境：语言/框架版本、系统、关键命令
  • 排查路径：试过哪些方向，哪些无效
  • 结论：最终有效的一步是什么

有时候结论只有一句话，例如「缓存没清」「依赖装到了错误的 Node 版本」。一句话也值得记，因为下一次最先怀疑的常常不是它。

工具别复杂

我试过专门的知识库，最后反而写得更少。现在更常用的是：仓库里的 notes/ 目录，或本站这种静态页。门槛越低，越容易坚持。

重要的不是系统有多完美，而是：三个月后你还能靠标题和关键词找回来。

写下来的副作用

写的过程会逼你把模糊感觉变成可验证的陈述。很多时候，还没搜到答案，问题本身就被澄清了。这对调试很有帮助。

记笔记不是为了成为作者，是为了少付第二次同样的时间税。