程序员的技术博客写作指南 [复制链接]

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

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

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

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

技术沉淀

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

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

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

打造个人IP

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

职场加分

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

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

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

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

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

明确写作目的和受众

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

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

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

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

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

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

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

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

制作思维导图

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

参考文献

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

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

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

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

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

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

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

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

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

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

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

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