如何寫出高質(zhì)量的技術(shù)文章?
955對(duì)于一個(gè)從小不喜歡語(yǔ)文、不喜歡閱讀、作文很少及格的理科生來(lái)說(shuō),做夢(mèng)也沒想到,有一天我會(huì)寫一篇文章教人如何寫文章 :)
一 為什么要寫文章
懂了,不一定能說(shuō)出來(lái),說(shuō)得出來(lái),不一定能寫出來(lái)。這就是寫文章最大的好處,官方術(shù)語(yǔ)叫“費(fèi)曼教學(xué)法”。寫文章是一個(gè)逼迫自己深入理解問題、把問題想清楚,整理好思路,并能清晰表達(dá)出來(lái)的過程。其本質(zhì)是一種自我學(xué)習(xí)、自我提升、構(gòu)建知識(shí)體系的最佳方法。
除此之外,寫文章還有一個(gè)副產(chǎn)品——幫助我們擴(kuò)大影響力。就拿我來(lái)說(shuō),我大概是在4年前,開始有規(guī)劃地搭建自己的知識(shí)體系,包括閱讀、記筆記、寫文章、分享。
在這期間,我連續(xù)3年獲得最佳年度作者,上頭條的文章也不少。另外,阿里技術(shù)公眾號(hào),也發(fā)表了我10篇左右的文章,其中有2篇入選了創(chuàng)刊最佳文章,很多篇文章都有3萬(wàn)+閱讀的不錯(cuò)表現(xiàn)。
基于這些總結(jié)沉淀,我在人民郵電出版社出版了一本書《代碼精進(jìn)之路:從碼農(nóng)到工匠》,我本人也憑借本書獲得了人郵IT類年度最佳作者。
二 什么是好的技術(shù)文章
關(guān)于優(yōu)質(zhì)文章的標(biāo)準(zhǔn),有一個(gè)對(duì)好文章的判斷是:“文章框架完整、思考深入清晰、正文至少80%以上為原創(chuàng)技術(shù)干貨。”這引起了不少的爭(zhēng)議。
有爭(zhēng)議很正常,沒有爭(zhēng)議才奇怪呢,好的技術(shù)文章,就和好的技術(shù)績(jī)效一樣,主觀性太強(qiáng)......很難有一個(gè)客觀標(biāo)準(zhǔn)。
如果硬要對(duì)文章質(zhì)量進(jìn)行量化的話,有些指標(biāo)可能有幫助。 比如文章的瀏覽量、點(diǎn)贊數(shù)、評(píng)論數(shù)、收藏?cái)?shù)等指標(biāo)。有用,但也只是參考作用,最后還是需要人的評(píng)判。
所以拋開這些因素不看,我認(rèn)為好的技術(shù)文章至少應(yīng)該滿足兩個(gè)條件:
一個(gè)是要傳達(dá)有價(jià)值的信息。
另一個(gè)是要結(jié)構(gòu)和邏輯清晰,具備一定可讀性和可理解性。
在此基礎(chǔ)之上,如果能做到有文采、夠風(fēng)趣那就更好了。
三 如何寫好技術(shù)文章
內(nèi)容有用
一篇好文章,一本好書,最重要的是要讓讀者有獲得感,要對(duì)讀者有用,要言之有物。
這里的“物”可大可小,不一定非要是一個(gè)很大的命題,恰恰相反,一篇文章的篇幅有限,能把一件“小事情”說(shuō)清楚就已經(jīng)很不錯(cuò)了。
我曾經(jīng)發(fā)表過一篇文章——《阿里縮寫和專業(yè)術(shù)語(yǔ)大全》,做的事情很簡(jiǎn)單,就是把我在阿里碰到的縮寫全都整理成冊(cè)。就這么一篇“小文章”,卻成了我最火的一篇文章,有將近100K的閱讀,3K的點(diǎn)贊。
為什么大家會(huì)如此關(guān)注這篇沒有“技術(shù)含量”的文章?很簡(jiǎn)單,很多人都有好奇心,大家都希望了解縮寫背后的全稱和來(lái)歷,這正是這篇文章的價(jià)值所在。
類似的,像云原生技術(shù)介紹、前端技術(shù)體系大全、新人入職手冊(cè)、《馬總演講集》等都屬于這種信息整合類的文章。
除此之外,那些有自己技術(shù)見解和思考,敢說(shuō)真話的文章,也會(huì)受到大家的歡迎。
比如,我覺得很多技術(shù)團(tuán)隊(duì)不應(yīng)該有架構(gòu)師這個(gè)崗位,所以寫了《人人都是架構(gòu)師:架構(gòu)是一種能力,不是title!》。我覺得很多的軟件復(fù)雜度來(lái)自于工程師的亂作為,比如濫用流程引擎,治理復(fù)雜度的根本是抽象思維和結(jié)構(gòu)化思維,于是寫了《一文教會(huì)你如何寫復(fù)雜業(yè)務(wù)代碼》。
這些文章之所以受到歡迎,是因?yàn)橐鹆撕芏嗤瑢W(xué)的共鳴,對(duì)他們有幫助。
結(jié)構(gòu)清晰
有了好的內(nèi)容,還要注意文章的結(jié)構(gòu)。就像一道菜,要講究色香味俱全,即使有了最好的食材,但是做出來(lái)的樣子一團(tuán)糟,也會(huì)影響食欲,稱不上是一道好菜。
關(guān)于結(jié)構(gòu),我推薦你去看一本書——《金字塔原理》,我本人也寫過不少關(guān)于結(jié)構(gòu)化思維的文章。金字塔原理教導(dǎo)我們?cè)趯懽鳌⒈磉_(dá)的時(shí)候,要構(gòu)建清晰的結(jié)構(gòu)。
對(duì)于一篇文章來(lái)說(shuō),金字塔的頂點(diǎn)是中心論點(diǎn)——通常就是文章的標(biāo)題。圍繞著這個(gè)中心論點(diǎn),我們可以用多個(gè)觀點(diǎn)去支撐中心論點(diǎn),如果表達(dá)的內(nèi)容很多,觀點(diǎn)還可以進(jìn)一步往下細(xì)分。形成一個(gè)“以上統(tǒng)下、邏輯遞進(jìn)”的金字塔結(jié)構(gòu)。
通過這種形式寫出的文章,就會(huì)顯得邏輯清晰,結(jié)構(gòu)緊湊。
對(duì)于技術(shù)文章來(lái)說(shuō),我們可以考慮使用3W2H模型來(lái)幫助我們構(gòu)建結(jié)構(gòu)。比如我要寫一篇關(guān)于抽象能力的文章,就可以通過以下角度去說(shuō):
- What:什么是抽象;
- Why:抽象為什么重要;
- How:如何進(jìn)行抽象;
- Where:抽象可以用在什么地方;
- How much:抽象到什么程度。
同樣,我現(xiàn)在正在寫的這篇文章,我也是通過這種方式來(lái)搭建結(jié)構(gòu)的:
刻意練習(xí)
開篇說(shuō)過了,我以前沒有寫作的習(xí)慣,小時(shí)候語(yǔ)文作文也經(jīng)常不及格。后面竟然出版了自己的書,說(shuō)明寫作作為一項(xiàng)技能,是可以習(xí)得的,是可以通過練習(xí)提高的。
因?yàn)閷懙亩嗔耍毩?xí)的多了,水平自然就會(huì)提高。然而,所謂的《刻意練習(xí)》(也是一本書),不是簡(jiǎn)單地重復(fù),而是要給自己階段性的設(shè)定更高的目標(biāo),這樣才會(huì)持續(xù)地進(jìn)步。
比如,我現(xiàn)在已經(jīng)能比較流暢地寫作,我就會(huì)去追求如何把文章寫的更加引人入勝。在《風(fēng)格感覺:21世紀(jì)寫作指南》里面提到一篇文章,它的開頭是這樣寫的:“我們都會(huì)死,我們是幸運(yùn)的...”,像這種沖突感和懸念,就會(huì)很自然地吸引讀者繼續(xù)閱讀下去。
我這篇文章也借用了同樣的手法 :)
迭代優(yōu)化
寫文章和寫代碼有非常多相似的地方。我會(huì)經(jīng)常拿寫文章和寫代碼做類比。比如,文章和代碼都需要結(jié)構(gòu)清晰。又如,好的系統(tǒng)不是設(shè)計(jì)出來(lái)的,是迭代出來(lái)的。好的文章也是如此,需要不斷的打磨、修改,我的很多文章都是經(jīng)過多次修改,重新編排結(jié)構(gòu),補(bǔ)充刪除信息,調(diào)整措詞,直到我覺得滿意為止。
就拿現(xiàn)在這篇文章來(lái)說(shuō),也是修改了好幾版,第一遍的時(shí)候內(nèi)容很散,結(jié)構(gòu)也不清晰,有點(diǎn)糾結(jié),不知道要如何寫下去。后面想到一個(gè)“以身作則”的方法,即這篇文章本身應(yīng)該就可以作為一個(gè)sample來(lái)介紹如何寫文章。帶著這個(gè)思路,迭代幾次之后,就逐漸成了一篇像樣的文章了。
所以,重要的是要敢于去“動(dòng)筆”,不要擔(dān)心一開始的粗枝大葉,萬(wàn)事開頭難,寫著...寫著... 你就有感覺了。