《代碼整潔之道》精讀與演繹】之一 讓代碼比你來時更干凈
“我們就是一群代碼猴子,上躥下跳,自以為領略了編程的真諦。可惜當我們抓著幾個酸桃子,得意洋洋坐到樹枝上,卻對自己造成的混亂熟視無睹。那堆“可以運行”的亂麻程序,就在我們的眼皮底下慢慢腐壞。”
本文引用地址:http://www.ex-cimer.com/article/201608/295974.htm——《代碼整潔之道》作者 RobertC.Martin,于SD West 2007技術大會
一、系列文章前言
敲完上面這段文字的時候,心里在想,一個剛踏入編程生涯的新人,要經歷多少的淬煉,才能領略到Bob大叔所謂的編程的真諦。
有人說,這個過程會很漫長,大概至少是在讀完N本編程領域的經典著作,并經過大量的思考與實踐之后。
而寫這個系列的起因,正是因為最近閑暇時一直在閱讀一些之前一直想看的經典著作,并有將閱讀過程中一些思考和總結記錄下來。為了不枉費這些閱讀、思考與總結的過程,決定將這些零散的內容整理成文,沉淀下來。過些年后再回首,也許會覺得當時的一些思考,彌足珍貴。
這個系列的文章,不僅僅是讀書筆記,而是對一本書核心內容的全新演繹,內容解刨,與重組。希望自己的這些文字,能對各位想進一步了解這些經典著作的讀者們有所幫助。
二、《代碼整潔之道》其書
《代碼整潔之道》(《Clean Code》)是幾乎每一個對編程境界有追求、有志于改善代碼質量的編程者,都應該閱讀的一本好書。
這本書提出了一個觀點:代碼質量與其整潔度成正比,干凈的代碼,既在質量上可靠,也為后期維護、升級奠定了良好基礎。
書中介紹的規(guī)則均來自作者多年的實踐經驗,涵蓋從命名到重構的多個編程方面,雖為一“家”之言,然誠有可資借鑒的價值。
三、本文涉及知識點思維導圖
先放出這篇文章所涉及內容知識點的一張思維導圖,就開始正文。大家若是疲于閱讀文章正文,直接看這張圖,也是可以Get到本文的主要知識點的大概。
四、糟糕代碼,是如何產生的
最初的問題來了,我們都不喜歡壞代碼,為何壞代碼還總會產生?
拋開編程者本身技藝的問題,答案也許是想要快點完成任務,項目進度趕著時間,或許我們只是不耐煩再繼續(xù)做這個需求,渴望它能早點結束。
很多時候,會有一堆事情壓著你去完成,你覺得自己需要趕緊弄完手上的東西,好接著做下一件工作,所以,為了走捷徑,為了特定實現(xiàn)功能而強加的糟糕的代碼,就悄悄地誕生了。我們都曾經瞟一眼自己親手造成的混亂,決定棄之不顧,走向新的一天,等有朝一日再來清理。
然而中國古訓有云,“明日復明日,明日何其多”,勒布朗(LeBlanc)法則也表示,“稍后等于永不。”你會發(fā)現(xiàn),因為各種各樣的原因,很多時候你根本都不會(沒時間)去整理之前的代碼。所以,正如本書作者Robert C.Martin(Uncle Bob),在SD West 2007技術大會上所說的,“那堆“可以運行”的亂麻程序,就在我們的眼皮底下慢慢腐壞。”
我們知道,壞代碼會污染環(huán)境,最后會壞掉整個項目。保持整潔的習慣,發(fā)現(xiàn)臟代碼就要及時糾正。花時間保持代碼代碼整潔,不但有關效率,還有關項目的生存。
五、為什么好代碼會很快變質?
為什么好代碼會很快變質?一般情況下,需求一直在變更、需求變化違背了初期設計、進度太緊是導致好代碼變質的誘因。
多數(shù)的產品經理想要好的代碼,即便他們總是癡纏于進度,他們會奮力的維護進度和需求。而程序員們則當以同等的熱情捍衛(wèi)代碼的整潔性和可擴展性。
舉個栗子,如果你是醫(yī)生,病人在請求給給他們做手術前別洗手,因為那會花太多時間,你會照辦嗎?本該是病人說了算,但醫(yī)生卻絕對應該拒絕遵從。為什么?因為醫(yī)生比病人更了解疾病個感染的風險。醫(yī)生如果按病人說的辦,就是一種不專業(yè)的態(tài)度。
同理,程序員遵從不了解混亂代碼風險的產品經理(策劃)的意愿,都是不專業(yè)的做法。
六、程序員的基礎價值謎題
程序員都面臨著一種基礎價值的謎題。有那么幾年經驗的開發(fā)者都知道,之前的混亂拖了自己的后腿,但開發(fā)者背負期限的壓力,只好制造混亂。簡言之,他們沒花時間讓自己做得更快。
而其實真正專業(yè)的人士明白,這道謎題第二部分說錯了,制造混亂無助于趕上期限,混亂只會立刻拖慢你,叫你錯過期限,趕上期限的唯一方法——做得更快的唯一方法——就是始終盡可能保持代碼的整潔。
七、大師們眼中的整潔代碼
到底什么是整潔的代碼?有多少程序員,就有多少定義。 “大師級程序員把系統(tǒng)當故事來講,而不是當做程序來寫”。就讓我們一起看看經驗豐富的大師級程序們都是如何定義整潔代碼的。
Bjarne Stroustrup ,C++語言之父, The C++ Programming Language(中譯版《C++程序設計語言》)一書作者:
“我喜歡優(yōu)雅和高效的代碼,代碼邏輯應直截了當,叫缺陷難以隱藏;盡量減少依賴關系,使之便于維護;一句某種分層戰(zhàn)略完善錯誤處理代碼;性能調至最優(yōu),省得引誘別人做沒規(guī)矩的優(yōu)化,搞出一堆混亂來。整潔的代碼只做好一件事。”
Grady Booch,Object Orient Analysis and Design with Application(中譯版《面向對象程序分析與設計》) 一書作者:
“整潔的代碼簡單直接,整潔的代碼如優(yōu)美的散文。整潔的代碼從不隱藏設計者的意圖,充滿了干凈利落的抽象和直截了當?shù)目刂普Z句。”
Michael Feathers,Working Effectively withLegacy programming(中譯版《修改代碼的一書》)一書的作者:
“整潔的代碼總是看起來想是某位特別在意它的人寫的,幾乎沒有改進的余地,代碼作者署名都想到了,如果你企圖改進它,總會回到原點,贊嘆某人留給你的代碼——全心投入到某人留下的代碼。”
Ron Jeffries,Extreme Programming Installed(中譯版《極限編程實施》)以及Extreme Programming Adventures in (C#中譯版《C#極限編程探險》)作者:
“減少重復的代碼,提高表達力,提早構建簡單抽象,這就是我寫整潔代碼的方法。”
八、編寫代碼的難度,取決于周邊代碼的閱讀難度
編寫代碼的難度,取決于周邊代碼的閱讀難度。何出此言?因為各種實踐與統(tǒng)計表明,在項目里開發(fā)新功能的過程中,閱讀之前代碼與書寫新的代碼,花費的時間比例超過10:1,新寫代碼時,我們一直在讀舊代碼。既然比例如此之高,我們就應該讓讀的過程變得輕松,即便那會使得編寫過程更難。
所以說,編寫代碼的難度,取決于周邊代碼的閱讀難度,想要快速實現(xiàn)需求,想要快速完成任務,想要輕松的寫代碼,先讓你書寫的代碼整潔易讀吧。
九、讓代碼比你來時更干凈
我們知道,光把代碼寫好可不夠,必須時時保持代碼整潔,我們都見過代碼隨著時間的流逝而腐壞。我們應該更積極地阻止腐壞的發(fā)生。
借用美國童子軍的一條簡單的軍規(guī),應用到我們的專業(yè)領域:
“讓營地比你來時更干凈。”
那么可以同樣對編程領域這樣說:
“讓代碼比你來時更干凈。”
也就是說,如果我們每次簽入時,代碼都比簽出時干凈,那么代碼就不會腐壞。這就是我們需要遵從的代碼整潔之道。
十、本文涉及知識點提煉整理
文章開頭部分已經用思維導圖的方式展現(xiàn)了本文的知識點,這邊再貼出一個文字列表版,方便大家整理:
1. 編寫代碼的難度,取決于周邊代碼的閱讀難度。想要快速實現(xiàn)需求,想要快速完成任務,想要輕松的寫代碼,請先讓你書寫的代碼整潔易讀。
2. 保持整潔的習慣,發(fā)現(xiàn)臟代碼就要及時糾正。花時間保持代碼代碼整潔,這不但有關效率,還有關項目的生存。
3. 程序員遵從不了解混亂風險的產品經理(策劃)的意愿,都是不專業(yè)的做法。
4. 讓代碼比你來時更干凈:如果每次簽入時,代碼都比簽出時干凈,那么代碼就不會腐壞。
5. 趕上期限的唯一方法,做得更快的唯一方法,就是始終盡可能保持代碼的整潔。
本文就此結束。
下篇文章,我們將繼續(xù)《代碼整潔之道》的精讀與演繹,探討更多的內容。
Best Wish~
評論