那天写教程差点把自己写崩溃了。

事情是这样开始的:我吭哧吭哧写了篇安装软件的文章发群里,满心等着夸。结果群友直接甩截图过来:“大哥你这写的啥玩意儿?我照着做三遍全卡住了!” 我凑过去一看,人家新手连“配置环境变量”是啥都不知道,更别说跟着我写的“sudo apt-get install”瞎折腾了。有个老妹儿更逗,私聊问我“依赖项缺失”是不是得去药店买药。

一、先得知道问题出在哪

避免专业术语使用绝招防坑秘诀等通俗词汇

我把以前发的东西全翻出来看,越看脸越烫。满篇都是“API调用”“异步加载”“线程池”——我当时觉得特专业特牛B,现在再看简直满嘴火星文。更打脸的是,底下评论全是“虽然看不懂但觉得好厉害”,压根没人说学会了这不自嗨吗?

二、动手揪术语

抽了张A4纸对折两次,左边列我这行当最爱用的装B词儿,右边准备换成地球话。写几个词就卡壳:

  • “底层架构” → 挠头想半天,改成“软件地基咋搭的”
  • “高并发支持” → 急得咬笔杆,憋出“几千人同时抢票不崩”
  • 避免专业术语使用绝招防坑秘诀等通俗词汇

  • “冗余备份” → 拍大腿喊“鸡蛋别放一个筐!”

最要命的是“分布式”,憋得厕所跑了三趟,画了个蚂蚁搬西瓜的简笔画才勉强说清。

三、拿自己开刀重写

翻出阅读量最低的那篇《数据库优化指南》当靶子,上来第一句原版是:“建立索引降低查询时间复杂度”。我盯着屏幕跟它有仇似的,删了写写了删。心一横改成:

“给数据贴标签,找东西快得像外卖APP搜店”

避免专业术语使用绝招防坑秘诀等通俗词汇

就这一句话,汗都出来了。后面每写三行就得查小学生词典,感觉脑子被掏空。

四、真人肉测

改完硬着头皮发家庭群。特意@了卖煎饼的二舅和读初中的表妹。忐忑等到晚上,二舅居然发语音:“外甥这个就是说把数据库当库房管嘛货堆整齐了找得快!” 表妹更绝,直接按我写的截图操作成功了——要知道原文她之前看三分钟就退出了。

现在总算明白了

以后再动笔,我就盯着两个事:第一,这个词我妈能懂不?第二,删掉这个词文章散架不? 上周写WiFi教程,把“无线射频模块”换成“路由器头顶那两根天线”,评论里再没人问“射频是充电宝牌子吗”。

技术圈最大的毛病就是不说人话。什么秘诀绝招,说白了就是写东西时把自己当小白,现在每篇文章写完我都先读给楼下修车大爷听,他点头了才敢发。

避免专业术语使用绝招防坑秘诀等通俗词汇