写作目的和内容决定技术文章贴代码的方式

早上看了一位朋友的文章,这位朋友在文章中犯了愁,他说:"我之前写过一些文章，因为没有贴代码，----准确的说，是没有贴全代码而遭人骂。",一些人直接给文章回复"说那么多废话干什么，快贴代码","把代码发至某某信箱"之类的.面对这样的留言,作者无语了,他们"是来这里找技术？还是找代码？",文章最后问道:"一篇真正的技术文章，应该怎么写？"

其实,经常在一些技术网站上泡的人,时常会看到这样的留言,我们大可不必为这些为烦恼.写我们的技术文章,让这类人叫去吧.让真正关心技术的人分享到我们的技术才是写作的目的和初衷.

我觉得贴不贴代码,贴什么样的代码,贴多少,这些问题应该由文章的写作目的,主题及内容需要来定.

因为,代码只是为了更加清晰明了的阐述我们要说明的内容,帮助读者理解作者的思想.对于那些与主题无关的,或对阐述主题可有可无的代码只会使文章更加难以让人明白,干扰正常理解与阅读.

那些只知道要代码的人,他们阅读的目的根本就不是想要了解你文章所阐述的技术,而仅仅是想得到你的代码.这样的人基本上可以看成是"IT乞丐",网络上的"IT乞丐"确实不少,但他们是永远也理解不了技术的真谛的.

我们写技术文章也不绝是为了得到这类"IT乞丐"的"赞赏",而是想和更多的人分享技术. 因此,对于那此只知道浮躁的叫嚷着要代码,又不知道去理解技术,不尊重作者写作成果的人,我们大可以不必理会,这类人不值得花时间和精力去满足他们.

授人以鱼,不授人以渔.技术比代码更重要.所以,我觉得写技术文章,应该着重阐述技术,这样,用心的读者能从中悟出许多,举一反三,逐类旁通,理解技术的真谛.而纯粹的代码基本上只能让人知其然,而不知其所以然.故只能把代码当成是技术文章的一部分,用它来更好的为阐述技术内含服务,为理解技术服务.

当然,如果文章引用的代码片段不足以说明技术,或代码本身让人迷惑,那将会使文章的功效大打折扣.因此,对于引用代码的选择是需要经过作者精心思考和设计选择的.不能只简单的COPY一段了事.选择代码例子时候应该考虑代码的完整性,严谨性和针对性.一篇好的技术文章所引用的每一个代码例子,都是经过作者精心设计的,精选的代码反过来可以使技术阐述更加明了,更加让人易于接受.

总之,作者根据文章需要来决定如何选用代码,选用好的代码可以使作者的文章生辉不少.