技术博客写作指南

1万 · 2021-2-20 09:09

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

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

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

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

为什么要写技术博客

技术沉淀
- 总结归纳：做技术的前几年其实大家的差距并不明显，但是到后来，大概5年左右，有人依然初级程序员，有人已经是架构师了。当然其中有很多因素影响，但很重要的一条是归纳总结的习惯，而写作是归纳总结的有力工具。在写作过程中能梳理思路，查漏补缺，有些想法在编程时并未想到，却在写作中想到。写得多了，知识点会连成线，结成网。
- 增强**：俗话说好记性不如烂笔头，随着年龄的增长，**力每况愈下。写作无疑是增强**的有效工具。
- 纠错：人在很多方面认知不足，有时甚至是错的。往往自己察觉不到。但是通过分享，会有些喷子和大神给指出来。这样认知不断更新迭代，就不会出现太多谬误。在正确的认知下会越走越远，越走越开阔。
打造个人IP
当今世界要说什么最值钱，影响力绝对占据一席之地。网红、明星为什么赚钱，就是因为他们的影响力，各行各业的大神都做自媒体，当然不是为了赚那点流量费，而是在扩大自己的影响力。未来人人都是自明星，中国市场这么大，任何一个小领域都有无限可能，谁的影响力大，谁就是赢家。而写作又是一个扩大影响力的工具。IP比较大的有阮一峰、廖雪峰、王垠等，每个小圈子也都有自己的明星。他们还用愁35岁会不会失业，编程干不动了该怎么办的问题吗？自然不需要。其他行业也都有了自己的网红，期望IT界的网红就是你。
职场加分
不知道大家有没有发现，有自己的博客去找工作是一个很不错的加分项。最起码说明你是一个善于总结学习的人，面试官可以通过博客更多地了解你，最好是把自己认为非常不错的**置顶，以此显示自己的水准。

为什么迟迟没写技术博客

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

不知道写什么，可以写一个简单的用法、冷门知识、课堂笔记、编程心得、技术分享、项目分享，项目中遇到的问题以及解决方案等。有小伙伴觉得太简单谁都会，没必要写。其实不管你写什么，都有人会，有人不会。再牛的人都有自己的认知短板。
害羞，怕写得不好没人看，写错了被嘲笑、攻击。其实完全没必要，只有不断有读者正面反馈才会不断进步。只要你敢写就有人敢看，只要有人敢批评，咱就敢改正。
追求完美，很多程序员对代码有洁癖，凡事力求完美，但是写作这个事没有完美，何况是刚开始。作家海明威说过：“一切**的初稿，都是狗屎。” 大作家都有这样的心态，我们又有什么放不开的呢？此时完成比完美更重要。

如何写技术博客

明确写作目的和受众
首先要明确写作目的，受众人群。也就是给博文定调，是轻松幽默、力求详尽，还是严肃认真、专业概括，亦或者其他风格。
写什么
- 自己看，就是随笔，个人笔记。可以随笔写，甚至可以是一句话，一张图。完全可以是自嗨文。
  自嗨文：网络流行词，就是调子很高，辞藻华丽，但没站在用户立场上写的**。
- 技术分享，这时就要考虑全面，不能写成自嗨文，要有一定的套路，要明确受众是哪些群体，是小白，还是高手，或者是领导。根据受众的喜好和自己的能力圈适当发挥。
  ——提出问题->分析问题->解决问题->总结经验，技术问题分享。
  ——摘要->简介->分支主题->总结，一般技术分享。
  ——是什么-原理-背景>解决了什么问题->基本操作->同类对比->总结，适合新技术分享。
- 约稿，一般情况甲方都会给一定的格式和要求，再结合技术分享的经验成稿。
怎么写
- 制作思维导图
  有时写着写着就写不下去了。如果提前搭好框架，做成思维导图，就会轻松很多，不至于写到一半卡壳。技术博客一般结构都是总-分-总。
- 参考文献
  在写作过程中会遇到认知盲区，或者有更权威的表达，我们可以引用，引用最好权威，注意要标明出处。建议引用占博文的比例不超过10%，太多就成了抄袭。如果实在不知道从何入手，如何写，也可以参考其他同类**，有时完成一篇博文要参考几篇甚至几十篇**。有些诚实的小伙伴会说这不成了抄袭吗? 抄袭和借鉴还是有本质区别，况且小白入手都是模仿，学习同行。慢慢就会有自己的风格和套路。
- 排版
  markdown，几乎是所有博客网站的标配。

去哪写

现在写技术博客的地方还是比较多，大家可以根据自己的喜好选择合适的平台发布自己的**，也可以多平台发送，分布式，扩大影响力。

选择平台的因素是：

SEO
影响力
自己喜好

下面列举几个比较主流的平台：

csdn：这是国内最老牌的博客论坛，大家比较熟悉。
优点：seo做得很好，用户量大。
缺点：很臃肿，广告满天飞，对新人不是很友好，很难脱颖而出。
博客园：这是第二老牌的博客网站了。
优点：同样是seo比较好，用户量大。
缺点：写作体验太差，像上个世纪的东西，不过它可以自定义博客样式，美化博客。
掘金，平台比较新。
优点：比较清爽，写作体验很好，可以写自己的小册子赚钱。
缺点：seo做得太差，搜索引擎基本看不到掘金的**，很多软广告，带有面试字样的标题都是送资料引流的。
v2ex，技术氛围也不错，就是个人不太喜欢它的界面风格。
思否，更多地专注于技术问答的平台。回答质量也很高。
腾讯云社区，很多大牛，不太适合新人。写一段时间后可以去里面同台竞技。
阿里云云栖社区，同腾讯云社区。
简书，不是专门的技术网站，但也支持markdown，seo权重高。
知乎，更专注于问答，seo权重高，适合引流。
公众号，没有门槛，原则上要把自己的粉丝引到公众号上来，值得长期经营。
独立建站，就是比较麻烦，但是更容易掌控，自己的地方自己说了算。一些大牛都有自己的博客网站。比如：廖雪峰、阮一峰、轮子哥，知乎“温赵轮”三大软狗之一、王垠等。