如何写技术博客

如何写技术博客

关于如何写技术博客网络上有着无数个版本，每个人都有自己的见解，想写一篇这样的文章已经很久了，但是一直不知道如何出手。之所以不知道该如何落笔，一方面是因为我知道这样的文章很容易引起口水战，这是我最讨厌的事情，另一方面是让人感觉自己好为人师，虽然自己对技术也有一些积累和心得，但是由于自己就是一个讨厌别人告诉自己该干什么干什么的人，己之不欲，勿施于人，所以一直迟迟不得落笔。

直到今天，无意间在网上看到了一篇文档，这篇文档叫“跟我一起写make file”，作者是酷壳的陈皓，文档不算短，pdf版本的有78页。刚开始我只是随便看看，但是慢慢的，我发现这篇文章写的太好了，由于个人对make file之前有所了解，一口气花了5个小时的时间看完了这篇文章，但是并不觉得累，原因很简单，文章写的非常通俗易懂，完全是人家心得的东西，一看就是行家离手。

看完这篇文章，我觉得我该说些什么，关于写技术博客的。

首先，什么样的东西应该写，什么样的东西不该写？

说这个可能会刺痛很多人的神经，有句话是这么说的：学比处于心得，业必归于专精

如果不是自己有所心得，那么还是不要写了，不仅自己没有收获，浪费了时间，对比人也没有帮助。

第二，当自己写博客的时候问自己一个问题？对于要写的东西，我自己吃透了么，写博客不是stackoverflow, 不是向别人问问题，通常是自己要阐述某个方面自己的心得，当然并不是说不可以讨论，但是讨论的前提是you have the knowledge。

第三，对于一篇博文的定位，是知识梳理的，或者新技术的，或者难点易错的解析等等，定位好了才容易使一篇文章短小精悍，有形有神。

第四，对于博文标配的代码，最好带注释，你是在写文章，不是在写代码，好多人就直接贴一屏的代码，就成了一片博文，难以理解。

第五，在对于博文阐述的技术进行交流的时候，要尽量避免不礼貌的行为，有些博文的作者文章写的还行，但是每每和别人交流的时候就动辄骂娘，个人觉得很是不和谐，当然也可能事出有因，在此只是提出来，建议大家不要这样做。

第六，对于写博文是某些博主的炫技（就像有钱人炫富），这种炫技是本来很简单的东西，可能别人只不过是没接触过，作者却把整个东西写的很复杂，其实他心里很清楚，只不过是故意写的很深奥，显得自己很牛。

总结

当然作为写博客不应该有的情况还有很多种，在此不可能穷举出来，在某些方面我自己也做得不够好，写这篇文章算是对自己的总结和警示，当然也希望大家也思考一下该如何写技术博客，另外，对于文章中提及的情况，请不要对号入座。最后因为本人讨厌口水战，所有如果是沟通交流，欢迎指教，如果是口水战，请绕道，对不起，对于没意义的事情，兄弟没时间。