技术博客最容易被低估的价值,不是流量,而是给自己留下可回看的记录。
为什么记录
一个问题的解决过程,如果不写下来,三个月后就只剩模糊的印象:好像当时改了个配置,具体是什么已经忘了。
记录能带来三件事:
- 写清楚的过程,本身就是一次复盘;
- 下次遇到相似问题,有可复现的答案;
- 对外公开时,还能收到别人的补充和纠正。
记录的原则
- 写结论,也写推导过程,过程比结论更稀缺;
- 给出可复现的最小步骤,而不是只贴一段代码;
- 区分事实、猜测和未验证的部分;
- 承认当时选错了,错误经验同样有价值。
一篇好的技术笔记,应该像一张图纸:别人能看懂,也能照着施工。
频率比篇幅重要
不必等一个大项目结束才写。一个小问题、一次配置排查、一个 API 的奇怪行为,都值得记。
写得短没有关系,重要的是持续。站点的文章列表按时间排成一张张编号图纸,回看时能看到自己在哪些问题上反复跌倒,又在哪些地方真正前进。