技术文章如何写作能让读者有较好的阅读体验，是一个仁者见仁，智者见智的问题。甚至很多人都认为根本不需要考虑读者的感受，把技术写好写准确就可以了，这其实就是一大误区，你的写作如果只是给自己看，当然我也就不多说什么，但如果你的写作是给别人看，就一定要考虑如何写的问题，因为这是一个信息传递的过程而不是简单的记录。
　　事实上，对于一个准备开始写作的人来说，通常是会认为自己写的东西一定是对的。如果一定要完全正确才可以写文章的话，那就会让绝大多数人裹足不前。因此，写得对不对虽然是作者应该首先要把握的，但是无论作者自己还是别人都无法在写出文章公布之前知道这一点，因此这不是我本文要谈的重点。
　　我的核心观点是： 好的技术文章，是让符合阅读条件的读者，在良好阅读体验的情况下，看懂学会甚至掌握文章要传达的信息。因此，需要写作中不断思考，这样写，读者会有什么感受。如果你的写作不能让读者有一种收获的喜悦，或者阅读体验不佳，那么你的写作就是有问题的。问题可能会有很多方面，我们一点点分析。
　　要告知读者文章适合什么人读
　　首先要告知你写的文章适合什么人读，这尽管不是最重要的条件，但你是打算一开始就告诉读者，这文章的适读人群，还是让读者需要读完文章后再自己去判断这文章可不可以看得懂，两者在阅读体验的感觉是完全不一样的。通常一篇文章对于某个读者不是太浅，就是太深。正好是自己不了解的技术知识，自己有兴趣，而又能通过阅读看得懂的文章才是适合的好文章。因此由于读者层次不同，你的文章给什么人看的定位就很重要。
　　你把你的文章放到了博客园首页上，那就意味着不管什么层次的读者都可能点击进去。你如果不告知读者，这个内容至少需要具备什么样的条件才能阅读，对于一篇有一定技术难度的文章，初学者去阅读它，怎么可能高兴得起来。
　　反之，如果你在一开头就写明，此文必须要有A、B、C的知识，否则还是不看为妙，那么误入的读者至少可以不需要继续往下看，或者有个心理预期，可能看不懂，不过反正自己也没到那个层次，没什么关系。
　　如果将写作的具体技术难度分为九级（九级最高），你打算写一篇难度为七级的文章。此时，你不应该考虑水平在一、二、三级的读者，而是将四、五、六级的读者作为目标群，因为你的难度应该要让读者稍微费点力就够得着的，而不是那种根本看不懂的人，这样的定位才会更有针对性。如果你写的内容连二、三级读者都能读懂，那就说明实在是太啰嗦了，细节描述过多。如果只有七级水平的读者才能看得懂，那通常又是因为描述过于简洁而忽视了细节。这两种情况你的文章价值都会大大缩水。
　　清晰明白地指出文章适合什么样的人读，这有很多方法。可以是标题、摘要或者文章开头，只要达到提醒的作用，不要去浪费非目标读者的时间就对了。
　　另外，如果可能，还应该在文章末尾提供继续深入学习的建议，比如之后应该阅读什么书，看什么文章等。也就是说，你可以为你的读者指明了接下来学习努力的方向。
　　总之，你在一开头就告知此文章适合什么人读，帮助了读者节约了判别的时间，这是一个非常好的开始。
　　写作内容的难度层级递进
　　不要一上来就是关键知识点，那虽然是一种风格，但却违背了知识（或者说信息）传递的规律。
　　你在大街上看到了一漂亮姑娘，想让她成为自己的女朋友，你不能直接上去说“做我女朋友吧”，除非你开着法拉利或许可能。你首先要和她认识，并得到联系方式。简单的办法就是去搭讪。搭讪时如果直接说“给我你的手机号如何？”显然也是不合适的，除非你长着贝克汉姆的脸兴许可以。所以你得说点不让人反感的话。比如：“你那iphone如果开启手势功能，就不需要频繁按Home键了。不信？你看我的……”
　　举技术写作上的例子。在讲算法时间复杂度的知识点时，你当然可以直接讲时间复杂度的定义(就像大多数数据结构教材一样)，可这是很让读者，特别是刚学的人迷惑的，为什么要强调这个呢？而且由于一上来就是对大O阶推导，理解比较困难，读者的体验就相当差。
　　我在《大话数据结构》书中讲解的办法是先举了从1加到100的算法例子，对比容易想到的算法和高斯算法的差异，来引入算法优劣间的差异，并详细解释了函数渐近增长的原理，最后再来给出时间复杂度的定义，以及推导大O阶的方法。由于读者理解了函数渐近增长的原理，再去理解时间复杂度就变得容易了，这就是层级递进的作法。
　　运动员比赛前都需要热身，男女亲热前也需要前戏。同样，为了让读者进入阅读状态，用一些简单的例子来预热，用一些稍难的例子来铺垫，然后引出要讲解的重点，这样可以更好的达到讲解好知识的目的。
　　得用读者可以理解的语言，而不是你认为好的语言
　　微博上有这样一个段子。一位老太太想知道什么是Facebook，约旦VC Ahmad Takatkah的解释：
　　1)Facebook是一份报纸；
　　2)这报纸要在电脑或手机上看；
　　3)报纸里只有家人和朋友的新闻，第2页是儿子的、第3页是妹妹的…
　　4)关于他们的新闻他们自己写；
　　5)其中有一页是你自己的，想写什么想让谁看你说了算；
　　6)报纸第1页，是全部内容摘要。
　　怎么样，是不是感觉很不错？如果为了让老太太理解Facebook，去提什么这是一家社交网站，它可以向亲朋好友分享照片、视频和个人信息等很IT化的语言，她一定是非常困惑。她可能接着就会问“什么是社交网站”、“什么是视频”等问题了。
　　同样，你如果想让你的读者阅读体验好，就一定要用适合他们的文字，而不是你自己喜欢的文字，哪怕你的文笔相当棒。
　　这一条可能是最重要的一点，信息的传递最终都是为了让读者理解你的意图。写作时，一定要时刻想着用适合读者的语言来表达。
　　一图值千言
　　用上千个字描述不明白的东西，很可能一张图就能解释清楚。比如我在讲解数据结构的归并排序时，写了很多文字来说明排序的原理，但如果没有下面这样一张图，可能都是遗憾的。很多人也许就在看图的一瞬间，就明白了前面的迷惑原来就是因为大脑里没有这样一个类似的数据变换概念造成的结果。