竹笋

首页 » 问答 » 常识 » 程序员的技术博客写作指南
TUhjnbcbe - 2022/1/21 14:49:00
北京中科医院几级 http://pf.39.net/bdfyy/bdfal/161211/5112772.html

在开发过程中我们总会碰到这样那样的问题,神奇的是这些问题在网上基本能找到答案,不仅佩服这些大神大婶。

曾几何时,我也想成为他们那样的人,但对于写博客这件事一直敬而远之

编程本来就够无聊,写作更无聊,这两个无聊的东西加起来真不是稀顶就能解决的,可能得稀后脑勺。

让我想通了很多事,比如除了生死其他都是小事,比如要写技术博客。

为什么要写技术博客

技术沉淀

总结归纳:做技术的前几年其实大家的差距并不明显,但是到后来,大概5年左右,有人依然初级程序员,有人已经是架构师了。当然其中有很多因素影响,但很重要的一条是归纳总结的习惯,而写作是归纳总结的有力工具。在写作过程中能梳理思路,查漏补缺,有些想法在编程时并未想到,却在写作中想到。写的多了,知识点会连成线,结成网。

增强记忆:俗话说好记性不如烂笔头,随着年龄的增长,记忆力每况愈下。写作无疑是增强记忆的有效工具。

纠错:,人在很多方面认知不足,有时甚至是错的。往往自己察觉不到。但是通过分享,会有些喷子和大神给指出来。这样认知不断更新迭代,就不会出现太多谬误。在正确的认知下会越走越远,越走越开阔。

打造个人IP

当今世界要说什么最值钱,影响力绝对占据一席之地。网红、明星为什么赚钱,就是因为他们的影响力,各行各业的大神都做自媒体,当然不是为了赚那点流量费,而是在扩大自己的影响力。未来人人都是自明星,中国市场这么大,任何一个小领域都有无限可能,谁的影响力大,谁就是赢家。而写作又是一个扩大影响力的工具。IP比较大的有阮一峰、廖雪峰、王垠等,每个小圈子也都有自己的明星。他们还用愁35岁会不会失业,编程干不动了该怎么办的问题吗?自然不需要。其他行业也都有了自己的网红,期望IT界的网红就是你。

职场加分

不知道大家有没有发现,有自己的博客去找工作是一个很不错的加分项。最起码说明你是一个善于总结学习的人,下来面试官可以通过博客更多的了解你,最好是把自己认为非常不错的文章置顶,以此显示自己的水准。

为什么迟迟没写技术博客

很多小伙伴知道写博客的价值,也有过写博客的想法,但是出于种种原因始终没迈开第一步。近期采访了几位小伙伴,我总结了几个突出的原因。

不知道写什么,可以写一个简单的用法、冷门知识、课堂笔记、编程心得、技术分享、项目分享,项目中遇到的问题以及解决方案等。有小伙伴觉得太简单谁都会,没必要写。其实不管你写什么,都有人会,有人不会。再牛的人都有自己的认知短板。

害羞,怕写的不好没人看,写错了被嘲笑、攻击。其实完全没必要,只有不断有读者正面反馈才会不断进步。只要你敢写就有人敢看,只要有人敢批评,咱就敢改正。

追求完美,很多程序员对代码有洁癖,凡事力求完美,但是写作这个事没有完美,何况是刚开始。作家海明威说过:“一切文章的初稿,都是狗屎。”,大作家都有这样的心态,我们又有什么放不开的呢?此时完成比完美更重要。

如何写技术博客

明确写作目的和受众

首先要明确写作目的,受众人群。也就是给博文定调,是轻松幽默、力求详尽,还是严肃认真、专业概括,亦或者其他风格。

提出问题-分析问题-解决问题-总结经验,技术问题分享。

摘要-简介-分支主题-总结,一般技术分享。

是什么-原理-背景解决了什么问题-基本操作-同类对比-总结,适合新技术分享

自己看,就是随笔,个人笔记。可以随笔写,甚至可以是一句话,一张图。完全可以是自嗨文。

技术分享,这时就要考虑全面,不能写成自嗨文,要有一定的套路,要明确受众是哪些群体,是小白,还是高手,或者是领导。根据受众的喜好和自己的能力圈适当发挥。

约稿,一般情况甲方都会给一定的格式和要求,再结合技术分享的经验成稿。

自嗨文:网络流行词,就是调子很高,辞藻华丽,但没站在用户立场上写的文章。

制作思维导图

有时写着写着就写不下去了。如果提前搭好框架,做成思维导图,就会轻松很多,不至于写到一半卡壳。技术博客一般结构都是总-分-总。下面是一些我自己用的模板分享出来,做抛砖引玉用,各位如果有其他模板不妨分享出来,我们共同进步。

参考文献

在写作过程中会遇到认知盲区,或者有更权威的表达,我们可以引用,引用最好权威,注意要标明出处。建议引用占博文的比例不超过10%,太多就成了抄袭。如果实在不知道从何入手,如何写,也可以参考其他同类文章,有时完成一篇博文要参考几篇甚至几十篇文章。有些诚实的小伙伴会说这不成了抄袭吗?抄袭和借鉴还是有本质区别,况且小白入手都是模仿,学习同行。慢慢就会有自己的风格和套路。

排版markdown,几乎是所有博客网站的标配

去哪写

现在写技术博客的地方还是比较多,下面列举几个比较主流的

csdn:这是国内最老牌的博客论坛,大家比较熟悉,优点:seo做得很好,用户量太大;缺点:很臃肿,广告满天飞,对新人不是很友好,很难脱颖而出。

博客园:这是第二老牌的博客网站了,优点同样是seo比较好,用户量大。缺点:写作体验太差,像上个世纪的东西,不过它可以自定义博客样式,美化博客。

掘金,平台比较新。优点就是比较清爽,写作体验很好,可以写自己的小册子赚钱。缺点是seo做得太差,搜索引擎基本看不到掘金的文章,很多软广告,带有面试字样的标题都是送资料引流的。

v2ex技术氛围也不错,就是个人不太喜欢它的界面风格。

思否,更多的专注于技术问答的平台。回答质量也很高。

腾讯云社区很多大牛,不太适合新人。写一段时间后可以去里面同台竞技。

阿里云云栖社区同腾讯云社区

简书不是专门的技术网站,但也支持markdown,seo权重高。

知乎更专注于问答,seo权重高,适合引流。

1
查看完整版本: 程序员的技术博客写作指南