如何写出一篇技术博客文章并加以修饰

廖为祥 技术教程 深度好文如何写出一篇技术博客文章并加以修饰已关闭评论3,1261阅读模式

引子

众所周知,写博客是一种入门门槛低,疗效好,还能带来长期影响力的过程。几乎每一位爱上写博客的开发者总是乐于向其他人分享写博客的乐趣和益处,但即便如此,身边的人还是很难体会到写博客的好处。如何写出一篇技术博客文章并加以修饰

哪怕有时有的公司付费鼓励员工通过知识库的形式分享平时自己遇到的问题和解决问题时的思考,也鲜有员工薅到这样的羊毛,这确实是一件令人费解的事情。会不会是由于同事们不差钱呢?显然并非如此,每个月从200元到500元不等的奖金,每年累计下来也要大几千,估计很少有人能够克制这样的诱惑。

其实也许是因为存在一种心理障碍。年轻的开发者们还没有完成心路历程的转变,没有深刻的体会到写博客其实不是写作文,它不需要灵感,也不需要写出太高大上的文字,他的门槛其实是如此之低,与其说是知识输出,倒不如说是更像是软文或应用文。有时,你无需花太多的时间,只需按照一些简单的套路,其实就能踏上这条贼船。隔行如隔山,信息不对称的危害可见一斑。

 写博客的套路就是:提出一个问题,分析问题,解决问题,记下来。

啥华丽的辞藻,啥专业的解读,啥深度剖析,这些都不重要,这些都是循序渐进的过程。经典的小说千千万,经典的博客却少之又少。作为菜鸟的我们,又何必追求写出那么经典的博客呢?

为了让读者能够更加切实的体会这个观点,本文就是这样的示例代码(本文虽然是一篇博客,同样像一篇应用文,前面铺垫大家都可以理解为废话。


1、提出问题

在软件开发过程中,我们经常会遇到各种各样的问题,有的看起来毫不起眼,但也让人发人深思,有的问题则看起来就很复杂,但解决之道却如此简单。

所以,如何提出你发现的问题,就是写博客的第一步。

举一个很简单的例子: Thread.Sleep方法,好像参数只需一个整型数,就能享受让主线程阻塞的优雅性能。(阻塞线程显然不能带来性能快感,但有时吧。。)但你想过没,这个Thread.Sleep的最小值,居然不是0,而是-1,这是为啥呢?

如果你发现了这个问题,并提出这个质疑,也许一篇优秀的文章就在等着你。(当然,就.NET而言,微软官方已经围绕这个问题进行了解释)。

当然,这样的例子非常常见,我们也可以从http协议开始理解,这种无处不在的协议,究竟是如何运作的?这也是一个很不错的问题。

2、分析问题

透过问题的表象,看看问题本质的东西,这本身也许需要积累,有时也需要一些机遇。但在我们初涉博客时,只需多从几个角度剖析问题,借助一些知识整理,也许就能看到之前从未涉及的视角。

有时,我们也不必纠结写博客质量太低,担心被人称作南郭先生,其实大部分友好的技术社区大部分正常的读者,对持续坚持写博客的博主总是比较友好的。多关注于技术和作品本身,反而有助于我们屏蔽外界干扰,并从钻研技术的过程中获得更多乐趣。

3、尝试解决问题

依托互联网媒介,寻找问题的解决办法,并将解决问题的过程客观真实的描述下来。有时也许只需一行代码,或一个流程图,就能给读者解决很多问题。

4、稍微修饰一下

当然,如果你能再写完博客后,花一点点时间对内容进行一些修饰,自然而然就会获得更多的读者了。

1、加强文章的排版,注意字体大小的错落,注意换行等。在手机上阅读大段大段的文字着实不便,如果我们能控制每段的文字数大概在100字左右,也许读者会轻松许多。

2、去掉那些过于华丽的辞藻。作为一篇技术博客,辞藻华丽不仅仅没有优点,反而会让读者远离。。

3、注意引文的实时性。考虑到技术博客本身刷新的频率特别高,如果你能基于最新的知识体系进行写作,自然而然也会让更多开发人员从中获益。

4、适当的留下伏笔。虽然一篇文章力求解决一个问题,但如何能够为下一篇文章介绍的内容埋下伏笔,也能让你的博客获得更多吸引力。

5、多坚持一下

对大多数人而言,技术写作是一件令人困惑的事情,俯拾即是的技术问题,难免都会让人产生动笔的冲动,但自我怀疑和混乱迷思,却打破了我们的思考节奏,让我们最终没能迈出这一步。我们也可能会在文思泉涌和下笔如枯之间摇摆,有时搜出一些边边角角的话题,然后写出了一篇越写越没劲的话题。但也许,我们的工匠精神也正是在这样的每一瞬间慢慢积累,并让我们最终获益。

抛弃幻想,放下自我,让博客能够更好的成为我们成长的利器,投入更多的坚持到我们真正需要关注的东西本身--技术上,确实会让我们获益匪浅。

在追求互联网速度、被各种应用干掉了大部分碎片时间的我们可能很难抽出写一篇博客的时间,但我们可以尝试一周输出一篇1500字的博客。每天花15分钟稍微写一点点,再周末花一点点时间打磨一下,也许一篇质量还不错的博客就形成了。

如果我们能坚持下去,一切都将大不一样。

继续阅读
廖为祥
  • 本文由 发表于 2021年1月7日 14:47:07
  • 除特别声明外,本站原创内容版权遵循 CC BY-NC-ND/2.5/CN协议规定