我写代码十五年，春哥最烦的技术就是那些把简单问题复杂化的教程。今天聊点实在的博客，关于技术博客这事儿。春哥

昨天半夜有个读者给我留言，技术说照着我的博客教程配服务器环境，折腾了四个小时没搞定。春哥我远程一看，技术问题出在他把配置文件里的博客冒号打成了中文全角。就这么个小坑，春哥教程里写了三遍“注意标点符号”，技术他还是博客掉进去了。这不怪他，春哥是技术我没把这事儿说得够扎心。

技术博客的博客本质是什么？是把你踩过的坑，用别人能听懂的话，重新埋一遍。但很多人写博客，活生生写成了产品说明书。功能列表、参数对比、操作步骤，规规矩矩，无懈可击，就是没人愿意看第二遍。

我自己的博客叫《春哥技术博客》，听起来挺土，但访问量还行。为啥？因为我写东西从来不想着“全面”，只想着“解决”。比如写Docker部署，我不跟你扯镜像原理，直接说：你照着这个命令敲，如果报错，八成是网络问题，换个国内源，完事。就这，比那些洋洋洒洒五千字的原理剖析管用多了。

有人会问，那原理就不用学了？学，当然要学。但那是你自己的事，别把学习笔记当教程发出来。读者要的是“怎么办”，不是“为什么”。这就像你去饭馆吃饭，厨师不需要跟你解释火候的分子运动学，你只关心菜好不好吃。

写技术博客还有个反常识的点：越具体越受欢迎，越抽象越没人看。我写过一篇关于MySQL索引优化的，标题叫《别再用LIKE '%关键字%'了，同事看了想打人》。内容就讲了一个案例：某后台管理系统查询慢，慢到点一下按钮能去泡杯咖啡。我把它拆开，一步步演示怎么用EXPLAIN看执行计划，怎么建联合索引，最后查询时间从3秒降到0.02秒。评论区炸了，全是“早看到这篇就好了”。

你看，没有高深的理论，就是一个真实场景的完整复盘。这种内容，搜索引擎喜欢，读者也愿意收藏。

当然，写博客这事儿，坚持比技巧重要。我见过太多人，开号的时候热血沸腾，立flag说每周更新，结果三篇之后就没动静了。我自己的习惯是，不刻意追求更新频率，但每篇必须解决一个真实问题。有时候一个月写一篇，有时候一周写三篇，全看手头有没有值得写的素材。

素材从哪来？从报错里来，从同事的抱怨里来，从技术社群的提问里来。前阵子群里有人问了个冷门问题：Nginx反向代理WebSocket老是断连。我刚好踩过这坑，花了半小时写了篇排查过程，连抓包截图都放上去了。后来这篇文章被转了上百次，比那些热门框架的教程传播还广。

说到底，技术博客拼的不是技术深度，是共情能力。你得记得自己当年菜鸟时期有多笨，才能写出让现在的新手看得懂的东西。忘了这一点，你就只是个会写代码的复读机。

行了，今儿就唠到这儿。我要去修那个全角冒号的bug了——顺便把教程里那句话改成红色加粗，再配个错误截图。下次再有读者踩这坑，我直播吃键盘。