返回首页

写技术博客的几个习惯

不追更新频率,但每篇都希望未来的自己能用得上。

3 约 2 分钟 · 1006 字 随笔

写博客这件事,我前前后后开了又荒废过好几次。后来才慢慢摸出一些“能坚持下来”的小习惯,顺手记一下。

1. 写给“半年后的自己”看

这是我现在选题最重要的标准:

半年以后再遇到这个问题,我会希望当时的我留下点什么?

带着这个视角写,内容自然会偏“工具书”,而不是流水账。你会去补背景、补失败案例、补关键命令,而不是一句“按 xxx 文档操作即可”草草带过。

2. 一次只回答一个问题

很多人(包括早期的我)写一篇文章时,会想把“我知道的全告诉你”塞进去,结果就是:开头跑题、中间冗长、结尾仓促。

更可靠的做法是:先把标题写成一个问句,然后只回答这个问题。其他延伸内容做成“小结里的待续”,留给下一篇。

3. 草稿放在能随手打开的地方

灵感总是出现在写不了博客的时候——通勤路上、洗澡时、写别的代码时。我现在习惯:

  • 想到一个选题,先在备忘录里记一行标题 + 三句要点
  • 周末固定挑一个动手写
  • 写到一半也敢直接保存,等下次接着写

这条看起来普通,但对“没在坚持的人”帮助最大。降低开始的成本,才会真的开始

4. 代码块比文字段落更值钱

技术博客里,能用代码示例说明的,就别用文字描述。读者来你这里,大多是要解决具体问题的,清晰的代码片段比一段散文式的解释更友好。

// 与其写:
// “你需要传入一个 options 对象,里面包含 host、port 等字段”

// 不如直接给:
const client = createClient({
  host: 'localhost',
  port: 6379,
})

5. 公开发布,但不焦虑数据

发布了就好,别盯着 PV 看。我有几篇阅读量很低的文章,反而是自己回头翻得最多的——比如一份很少有人遇到的报错的解决方案。

写博客最值得珍惜的回报,从来不是流量,而是:

  • 倒逼自己把模糊的理解写清楚
  • 半年后自己被自己救一次
  • 偶尔有人留言说“正好解决了我的问题”

这三件,任一件就足够。

小结

不追求更新频率,不追求阅读量,只确保:每一篇出现的时候,有用。这是我现在能保持长期更新的全部秘诀。