« Web开发杂谈(2) ——编程语言的入门科普 | Web开发杂谈(3) ——编程语言分类学 »

随心随笔(1)——如何写好技术博客

博客是个好东西，相信每个人都看过很多人的博客。我自己发现我的新知识的来源，博客已经占有了越来越大的比例。对于非常喜欢的博客，会收录到阅读器里，每篇必读；有的则是为了临时遇到的某个具体问题，通过搜索引擎找到的，问题解决了，也就过去了。但无论如何，在这种搜索中，都会有很大的收获。非常感谢很多博客给我带来的帮助。

写技术博客的好处

每一个技术人员都可以建立一个自己的技术博客，把平常的一些心得体会，实践经验写成文章，一方面这样对自己是一个很好的总结和提高，我自己的体会很深，我花了三个月的全天时间写了《CSS设计彻底研究》（台湾版名为《CSS Web设计大全》）这本书，使我对CSS的理解加深了很多很多；同时写的博客文章还会对其他人有所帮助，一举两得，何乐而不为呢？

此外，表达能力对于一个人的职业成长道路是很重要的，表达又分为“口头表达”和“书面表达”，都非常重要。前者如在大家开会的时候，你是否能够清晰明了地阐述你的想法呢？若你有这个能力，你的领导一定对你另眼相看，书面表达”也同样，如果你写出的技术文档、总结报告，总是内容翔实、条理清晰，你升职的时间就不远了。因此，完全可以把写技术博客作为对自己表达能力的一个锻炼机会，看看自己能不能写出高水平的文章来。

下面根据我自己的一点思考，说几条我觉得比较重要的原则。这并没有标准的答案，每个作者都有自己的想法，无法也没有必要寻找唯一的标准答案。

1：忌无关话题；贵在内容专注

有的人写博客，把生活中的内容，和技术上的内容混在一起，比如和某个朋友吃了顿饭，看了一个电影，听了一首歌，工作中解决了一个问题，都写进去。如果仅仅是为了当作自己的日记本，倒是无妨。但是对于这样的写作方式，如果希望给别人看，还希望别人也能喜欢，就不太容易了。毕竟咱们不是演艺明星，就算你觉得你的生活非常丰富多彩，也到不了别人会感兴趣的程度。而且，本来你的博客可能会有一些真正高质量的内容，会很很受欢迎，也被这些无关的内容淹没了。

如果你希望你的博客能更受别人的欢迎，最好能够先明确一点：你知道（擅长）的什么东西，是你知道，而别人不知道，又想知道的内容？找到了这样的题材，才是你的价值所在。你把你的内容锁定在这些你的“核心武器”上，才能写出成功的博客。

这些内容未必是你的专业，比如你的专业是程序员，但是你非常爱好羽毛球，而且到了有一定研究的程度，那么你就完全可以以之为题材，把你作为一个普通人，从零开始，不断提高的心得体会，写成博客，可以包括很多内容，比如关于比赛规则的分析、关于练习方法的体会、关于羽毛球明星的技术动作特点等等，设定好你的读者目标，比如和自己背景相似的羽毛球爱好者，用自己的语言，认真写好，就一定会有很多忠实的读者喜欢你的博客。

一句话总结：专注、专注、再专注！

2：忌只言片语；贵在描述清晰

我在查阅资料的时候，最郁闷的就是碰上这样的博客文章，明明他说的就是你想知道的事情，可是就是写那么一句半句，没头没尾的话，这样的博客，大多是博主为了怕自己忘记，给自己做的一个笔记，要么是一句话了事，要么是贴上一大段代码，也没有任何说明。自己明白，别人就很难明白了。

这样的博客同样只能当自己的日记，而无法给读者带去好感，如果要写技术博客，就应该设定一个明确的目标读者范围，为他们去写，要写某个你感兴趣的问题时，要把前言后语都说到位，把问题描述清楚，背景如何，问题在什么条件下发生，里面的根本原因是什么，然后给出符合逻辑的完善的解决方法，最后再做一下提纲挈领的总结，这样读者看后一定会感到心旷神怡。

就像在高考的时候，各科老师都反复嘱咐大家，回答问题的时候，一定要有中间步骤，不能只给一个结果，阅卷老师会按步骤给分。读者又何尝不是阅卷人呢？

一句话总结：是什么、为什么、怎么办，一个也不能少。

3：忌直接转贴；贵在亲身原创

很多人看到自己喜欢的文章，就把别人的文章“复制-粘贴”到自己的博客里，分享给别人，这当然也不错，但是这种方式是没有“技术附加值”的原生态产品。

如果你发现了一篇好文章，完全没必要他们复制过来，“超链接”是互联网作为媒体最大的一个特点，把别人的文章地址贴到你的文章中，引用的时候，把最核心的几句话摘录到你的文章里，一定要提到是谁说的，此外，一定要确保你的文章中主体部分是你写的文字，是你的思想的表达，而不仅仅是转贴。转贴是没有任何意义的事情。

这就好像一个你要开一个包子铺，你买来蔬菜、肉、面粉，花了80块钱，做成包子卖出去，你收了100块钱，那么你挣的20块钱，就是把原料变成包子的“劳动的价值”。你看到了别人的文字，直接转贴，就等于你买了一堆原料，直接又卖出去，没有创造任何价值。

一句话总结：不要作知识的搬运工。

4：忌过度修饰；贵在文风朴素

上面两种博客的缺点都是写作风格过于随意，缺少加工；而也有的少数博主正好相反，把博客当作了展示文采的舞台，虽然写的是技术问题，但是加入了其他很多东西，比如人物、情节等等。本来的目的是使自己的文章更有趣，更吸引读者。但是我个人的观点是，这样做可能没有必要，甚至画蛇添足。

简单一些的，编出两个人物，一个老师，一个学生，有问有答，文中穿插一些搞笑的语言， 这样还是可以接受的，毕竟对内容的干扰不是很大；更有复杂的，设计出若干人物，互相讨论，作者在写的时候，实际上花费了不少心思，为不同的角色设定不同的性格特征和“学识水平”， 但是短短的一篇技术文章，读者往往记不住那几个人物谁是谁，结果导致本来不难说清楚的事情，反而搞乱了。别人是来看你的技术内容的，而不是看笑话来的，不要过度修饰。写得再“妙趣横生”，也不能当喜剧搞笑片看吧。

凡是使用诙谐幽默的写法获得成功的面向大众的科普书，都是人文方面的，比如《明朝那些事儿》、《水煮三国》之类，文中加入一些小包袱，增加趣味性，其中重要的一点是，看这种书的读者本来就是抱着消遣的目的，读《明朝那些事儿》的读者，没有一个是为了研究明史的，都是为了看着玩儿的，了解一些历史典故，喝酒聊天的时候多一些素材，不会深究里面的内容。

而理工方面的技术书籍，就很难有人会抱着这样的心态去读。最好的博客文章应该是简单易懂，让读者花三分钟看明白，立马就能解决问题的文章。

一句话总结：不是必需的东西都删掉，一个多余字不留。

5：忌急于求成；贵在持之以恒

什么事情做几天都容易，难的是长久的坚持。很多人建立一个博客，一开始的时候热情很高，每天都琢磨有多少人来看，没多久就发现，根本没有几个人来，绝望……深深的绝望…… 算了，没意思，不干了！！

所以，关键就在于你是否能够坚持，做网站不是几天的事情，不是几个月的事情，至少先做两年再看看效果。坚持提供有价值内容，坚持足够的更新频率，坚持良好的互动，总会有人喜欢你的博客的。

一句话总结： 坚持、坚持、再坚持！

2,534

这篇文章发表于 2009年04月27日 星期一 9:00 am，并被分类于随心随笔。 您可以通过订阅 RSS 2.0 跟踪对这篇文章的评论。 您可以对这篇文章发表一条评论，或者在您自己的网站中引用 (Trackback) 它。

欢迎您发表留言

(须填写)
(须填写,不公开)

请注意：这里输入的HTML代码会被屏蔽，如果需要讨论复杂的具体代码问题，请到我们的论坛发贴，谢谢！

29条留言