写技术博客的一些经验分享

307 阅读13分钟

01 前置声明

01 本文结构

image.png

02 本文作用

对作者个人的话,梳理写作方式方法,完善个人的写作体系并形成写作机制

对大家的话,提供一些写作经验分享,比如阐述大家的技术需求提供写作方向,写作流程,写作时的心态等等

02 应用

01 编程学习演化

这是我长期在编程中的所思所想,这不仅是大家的需求,也是大家在技术的一些提升方向。

01 技术介绍与初步使用类

  • 介绍新知,概念是什么?他的作用又是什么?
  • 怎么进行环境搭建以及环境的配置?
  • 这个知识是怎么使用的?
  • 这个知识怎么被使用具体的场景(或者业务)?

02 知识原理与基于原理优化类

  • 这个知识的详细原理与底层逻辑是什么?以及寻找底层逻辑细节的具体步骤是什么?
  • 那基于底层细节和具体工具,那我们使用知识应该要注意的事项是哪些?或者通过底层原理怎么来高效使用工具?
  • 已知底层后,那么之后设计新工具怎么能优化后旧工具的缺点呢?

03 犯错与注意事项类

  • 运用知识发生错误的时候,怎么识别错误的,怎么进行改错的?错误的原因又是什么?留下具体的经验教训是什么?
  • 怎么对具体知识使用形成一套高效的排错与改错的流程机制是什么?

04 最佳实践类

-- 基于原理与犯过错误的长期实践中形成的

  • 如何优化迭代使用知识的过程机制呢(即对应场景的最佳实践)?
  • 已知底层后,那么之后设计新工具怎么能优化后旧工具的缺点呢?

02 需求与解决方案

01 技术介绍与初步使用类

  • 概念知识与宏观作用现在如果仅是理解的话,除了非常前沿的技术概念,那么现在真的可以询问市面主流Ai以这种方式请结合生活具体实例,生动形象地介绍XX
  • 环境搭建与配置更多还是需要图文和动态演示,这个真的可以去相关视频平台去看博主搭建,而且要尽可能要最新的,工具很有时效性,在快速变化的时代,工具教程的朝令夕改的确很正常了,比如现在docker的镜像源获取,2025年获取镜像源,现在并不是像以前简单的事情。作者在这吸收了一个惨痛教训。
  • 至于怎么使用知识,如果是简单的使用,没有逻辑复杂难度的话,跟1 + 1 = 2差不多的话,建议别写博客,写个总结使用文档来完善自己的知识体系,因为很简单的demo为什么不交给AI呢当然如果是比较新的技术还是写写,因为此刻知道的人稀少,是有价值的
  • 这个知识怎么被使用具体的场景(或者业务)这个问题,它能够深深引发自己的思索,来强迫自己来进行知识的梳理与内化,不论怎样,我们应该每隔一段时间应该提出并回答问题,来激发自己对知识的思考,使自己不断成长。 同时也是大家爱看的东西,因为这个一般都是比较有含金量的。

02 知识原理与基于原理优化类

  • 这个知识的详细原理与底层逻辑是什么?以及寻找底层逻辑细节的具体步骤是什么?
  • 那基于底层细节和具体工具,那我们使用知识应该要注意的事项是哪些?或者通过底层原理怎么来高效使用工具?

目前作者能力有限,没有足够多的积累来给出一套好的解决方案。

03 犯错与注意事项类

  • 运用知识发生错误的时候,怎么识别错误的,怎么进行改错的?错误的原因又是什么?留下具体的经验教训是什么?
  • 怎么对具体知识使用形成一套高效的排错与改错的流程机制是什么?

目前作者能力有限,没有足够多的积累来给出一套好的解决方案。

04 最佳实践类

基于原理与犯过错误的长期实践中形成的

  • 如何优化迭代使用知识的过程机制呢(即对应场景的最佳实践)?
  • 已知底层后,那么之后设计新工具怎么能优化后旧工具的缺点呢?

目前作者能力有限,没有足够多的积累来给出一套好的解决方案。

05 具体文章落地

这个世界是复杂的,每个人都有不同层次不同阶段的,并不是每个人都能按照以上的方向能够写博客,我们要认识自己的层次与所处的阶段,按着自己的实际来写博客。阶段的跨越并不是简单的事情,它是长期实践形成的宝贵经验和不断深化内心的思维,不能速成,是时间的礼物。 借鉴掘金作者九心大佬的思路,进一步优化,给大家一些具体落地的方向。

  • 没入行或者初级的时候
  1. 大厂面试题或者经典面试题
  2. 体系知识梳理
  • 中级工程师
  1. 新工具的快速入门教程
  2. 原理解析,技术或框架的底层逻辑与设计思路
  3. 犯错后的分析与解决解决方案
  4. 原理 + 犯错后的具体业务最佳实践
  • 高级工程师
  1. 进行分析与构建架构
  2. 创建新工具

03 写作的流程机制

每个人应该在实践中逐渐形成自己的写作流程机制

这是本人的写作流程机制,供大家参考

01 积累思维

任何idea都是在实践产生的,有idea最好快速通过手机的便签进行记录

其实任何idea都是基于自己一定兴趣而产生,不然你脑中怎么会有这个idea

如果是宏观思想与方向的话,做一个简单的描述

 # 时间 + 地点 + 心情/心态
 # 某件事情/实践引发的思考
 具体的宏观思想

如果是具体事情的具体路径,做一个快速的描述,不需要问自己为什么

只问自己怎么做,把粗糙的想法快速记录下来,最好还是语言转文字

将当时自己的所有想法一次性全部记录完

 # 具体事情是什么,自己的想法是什么
 方向1怎么做
 方向2怎么做
 .....

02 细化方向与内容

等自己有大段空闲时间来撰写文章后,

  • 那么我们不仅通过自己的粗糙记录来提供具体的方向,通常可以借用思维导图来梳理方向
  • 也要通过结合具体实例不断反问自己,狠狠地逼迫自己产出。

以下这是我具体写上面结论的思考

 - 你要解决的问题是什么?
 是强迫自己产出
 ​
 - 怎么进行逼迫呢?
 从读者阅读这段内容的时候能够很清晰的知道我要做些什么。
 ​
 - 怎么具体的清晰呢?
 用大白话,不用专业术语
 ​
 - 怎么提高自己的可读性? 
 先通过简单的分点,后期再通过Html格式进行优化

03 借鉴他人

为什么要借鉴他人?还是那句话,

世界是复杂的,每个人的局限在于只能看到他眼中的世界,要超越自己的局限,就要批判地接受他人的看法,不断打磨细节,迭代优化,成为一个动态优秀的文章

借鉴掘金作者一袋米要扛几楼的观点,原文如下。

  • 有时候我们看了一本书或者文章,深度吸收了它的思想,然后写成文章分享出来,但怎么看怎么像抄袭!这就是继承的缺点
  • 于是我们再去看看同类型的书或文章,吸收不同的见解和看法,形成自己的思考见解。然后写出来的文章往往就更有深度和格局了!这就是组合优于继承

04 把自己当读者

自己虽然是作者,但也是第一读者。

虽然自己作为作者,已经了解全文的意思和结构,

  • 但是不代表自己能够表达清楚给读者
  • 也不能保证全文没有错别字

我们需要以读者身份来审视自己的作品,去阅读文章的方式来优化自己的作品。

这是我常反问自己的问题

  • 是否能够结构清晰,逻辑合理,重点明确,能够快速让我阅读起来,知道有些什么,有哪些作用
  • 是否尽量通俗化,大白话化,能不能尽量结合生活案例或者自己遇到的生产案例来进行佐证
  • 阅读起来,是否看到有语病的句子(有歧义的句子一般都很难找出来,因为思维已经定时)
  • 是否能够吸引读者的阅读兴趣呢,是否能够每间隔后通过问题引发读者的思考
  • 首尾是否能够明确结论,给读者总分总的结构,而非让读者进行最后总结

05 全文优化

如果还有时间进行优化文章外观,目的是增加读者的可读性:

  • 增加图片: 引导大家能够持续读下去
  • 小故事或者亲身经历: 让大家感同身受
  • html进行优化: 增加点美观

03 心态

01 理科生的心态误区

还是一个简单的理科思维,自己能做出的题都是简单题,自己做不出来的都是难题,简单题不必要表达,默认人人都会,没必要造水。难题没拿实力, 就不当小丑了。

这种思维有他的好处,不愿意进行灌水,能有效提高平台的含金量。但是当我们有自己独特的感悟与思维了(在没有任何了解过,就是自己纯粹想出来) 。即使前人已经做过了,说过了,但是你应该写的。为谁写,写给自己, 我写这个并不是证明自己与前人的思想契合,彰显我什么的,而是我要肯定自己,这就是我认为的独立思想

而且人的成长就是就像固定容量的双端队列,不把自己旧的脑海的思维与解决方案出列的,怎么会有新的思维与解决方案进入脑海这个队列之中呢?去不断逼迫自己成长的,将自己的脑海的思维与解决方案出列并且以文字记录方式来输出

02 要创建一个好产品的心态

一个好的产品是迭代的,是不断进行打磨,优化的。

这个产品的前提是自己有兴趣,而且愿意去做。

并不是每一篇文章一开始就能写好,也并不是角度齐全的,甚至除了自己以外,没有什么可读性。或者自己的能力有限,暂时没有能力完全写好。

但是计算机的强大功能之一在于可以持续迭代,我一天天不断成长,不断吸取宝贵经验,即时是一开始很水很垃圾的文章,持续不断优化,不断重构,不断迭代,终将可以将产品变得很优秀。

03 非功利的心态 -- 去流量化

有些作者来到掘金平台来创作,带着像短视频的流量热点思维,用这样的思维来创作文章。我觉得完全没必要,因为都来掘金平台,那就应该脱离那些奶头乐的思维,这不是短视频平台,

这是一群对技术热爱的人。水文和标题党尽可能要少。毕竟你写水文有什么用,不仅降低了自己的含金量,而且掘金平台又不会给你钱,完全没必要。

如果你是想将这个经历放到简历上,面试官一看你的文章,要技术含金量没有,哪有什么用呢?技术岗位是用技术说话的,写博客尽量写含金量的,比如对mysql增删改查底层探究与写sql语句时候的最佳实践角度等等,面试官说不定就少让你背点八股,岂不美哉。

还有,请降低自己发出文章的阅读量,在掘金平台上,甚至你精心写好的文章连十个人都没有看。起码要有这个心理预期。

文章的第一读者永远是自己,而不是其他读者。那就自己严格要求自己,哪怕自己自娱自乐,但只要能看得懂就行了。创作是为了自己,其次是他人, 。写技术博客就像写算法题目一样,是需要时间的。但是写技术博客能按着自己的意志来写的,像一些算法题只能是独特的解。今天我们不必要按照高中时候的议论文一样的格式,想怎么写就怎么写,写作不把自己写爽,还写什么文章呢

当然如果你认为你文章真有含金量的话,想初期获得一下反馈的话,我还是觉得可以进行必要的标题化的,因为人性是如此,不论是读者想收获独特的实用知识,还是作者想获得读者的讨论与建议都是如此,都是希望自己做的事情受得反馈。之前是自己太自信了太乐观了,但还是发现要一点反馈感的。

对某些作者的吐槽

首先经典贩卖焦虑,还有急功近利的文章。这种作者真是个出生,仗着自己多学点或者多了解点东西,不仅给大家带来焦虑,而且文章质量差,整体断头断尾的。建议掘金平台优化推流机制,降低这些人的展示量

还有有一些水文,比AI还差,看过一篇文章,整体大意为要提升自己,与一起团队好好合作,细心一看,一个具体路径都没有。掘金应该降低这些人的文章展示量。

04 迭代优化

第一版于2025年03月19号发布,初步搭建了简单的写文章基本结构。

第二版于2025年04月20号发布,吸取掘金两篇文章,借鉴优化自己的文章,同时将近期的实践得来的经验融入文章中。并更名为《写技术博客的一些经验分享》

热门博客到底是怎么写的?

我是如何写好一篇技术博客的