代碼整潔之道

1、即便是在宏偉的建筑作品中，我們也聽到關(guān)注細(xì)節(jié)的回響。認(rèn)真對待每個變量名，你當(dāng)用為自己第一個孩子命名般的謹(jǐn)慎來給變量命名。全新傾注于細(xì)節(jié)，屢見于追求卓越的行為之中。小處要誠實(shí)。是否已盡力“把露營地清理得比來時還干凈”？簽入代碼前是否已做重構(gòu)？是的，我們就是一群代碼猴子，上躥下跳，自以為領(lǐng)略了編程的真諦。可惜，當(dāng)我們抓著幾個酸桃子，得意洋洋坐到樹枝上，卻對自己造成的混論熟視無睹。那堆“可以運(yùn)行”的亂麻程序，就在我們眼皮底下慢慢腐壞。稍后等于

2、永不（Laterequalsnever）。制造混亂無助于趕上期限?；靵y只會立刻拖慢你，叫你錯過期限。趕上期限的唯一方法——做得快的唯一方法——就是始終可能保持代碼整潔。整潔的代碼只做一件事。代碼應(yīng)當(dāng)講述事實(shí)，不引人猜測。如果每個例程都讓你感到深合己意，那就是整潔代碼。如果代碼讓編程語言看起來像是專門為解決那個問題而存在，就可以稱之為漂亮的代碼。有意義的命名：有意義的命名：變量、函數(shù)或類的名稱應(yīng)該告訴你，它為什么會存在，它做什么事，應(yīng)該怎

3、么用。如果名稱需要注釋來補(bǔ)充，那就不算是名副其實(shí)。程序員必須避免留下掩藏代碼本意的錯誤線索，應(yīng)當(dāng)避免使用與本意相悖的詞。以同樣的方式拼寫出同樣的概念才是信息，拼寫前后不一致就是誤導(dǎo)。要區(qū)分名稱，就要以讀者能鑒別不同之處的方式來區(qū)分。使用可搜索的名稱：長名稱勝于短名稱，搜得到的名稱勝于用自造編碼寫就的名稱，名稱長短應(yīng)與其作用域大小相對應(yīng)。不必用前綴來標(biāo)明成員變量。專業(yè)的程序員了解，明確是王道，專業(yè)程序員善用其能，編寫其他人能理解的代碼。類

4、名和對象名應(yīng)該是名詞或名詞短語。方法名應(yīng)當(dāng)是動詞或動詞短語。函數(shù)名稱應(yīng)當(dāng)獨(dú)一無二，而且要保持一致，即同樣的目的以同樣的命名稱呼。別用雙關(guān)語，即不要同一術(shù)語用于不同概念。使用異常替代返回錯誤碼，當(dāng)返回錯誤碼時，就是在要求調(diào)用者立刻處理錯誤。最好把try和catch代碼塊的主題部分抽離出來，另外形成函數(shù)。使用異常替代錯誤碼，新異常就可以從異常類派生出來。注釋：注釋：如果你發(fā)現(xiàn)自己需要寫注釋，再想想看是否能用代碼來表達(dá)。注釋存在的時間越久，就

5、離其所描述的代碼越遠(yuǎn)，越來越變得全然錯誤。原因很簡單那，程序員不能堅(jiān)持維護(hù)注釋。代碼在變動，在演化。從這里移到哪里。彼此分離、重造又合到一起。注釋并不總是隨之變動。注釋常常會與其所描述的代碼分隔開來，孑然飄零，越來越不準(zhǔn)確。真實(shí)只在一處地方：代碼。只有代碼能忠實(shí)地告訴你它做的事。那是唯一真正準(zhǔn)確的信息來源。所以，盡管有時也需要注釋，我們也該多花心思盡量減少注釋量。注釋不能美化糟糕的代碼，如果代碼爛不是應(yīng)當(dāng)寫注釋而是把代碼搞干凈。帶有少量

6、注釋的整潔而有表達(dá)力的代碼，要比帶有大量注釋的零碎的而復(fù)雜的代碼像樣得多。能用函數(shù)或變量時就別用注釋。注釋的作用是解釋未能自行解釋的代碼。短函數(shù)不需要太多描述。為只做一件事的短函數(shù)選個好名字，通常要比寫函數(shù)頭注釋要好。關(guān)系密切的概念應(yīng)該互相靠近。一般而言，我們想自上向下展示函數(shù)條用依賴順序，被調(diào)用的函數(shù)應(yīng)該放在執(zhí)行調(diào)用的函數(shù)下面。像報紙文章一般，我們指望最重要的概念先出來，指望以包括最少細(xì)節(jié)的方式表述它們。我們指望底層細(xì)節(jié)最后出來，這樣