閱讀《代碼整潔之道》有兩種原因颁独，第一種：你是個程序員彩届；第二，你想成為更好的程序員誓酒。
讀完后樟蠕，你能獲得如下技能：
- 知道更多關(guān)于代碼的事兒
- 辨別好代碼和糟糕代碼的差異
- 學(xué)會如何寫出好代碼
- 學(xué)會如何將糟糕代碼改成好代碼
Later equals never. 有些事兒現(xiàn)在不做以后都不會做了。
程序員基礎(chǔ)價值謎題
以前混亂的代碼拖了自己后腿靠柑，但開發(fā)者背負(fù)著期限的壓力寨辩，只好繼續(xù)制造混亂。而制作混亂無助于趕上期限歼冰。
趕上期限的唯一辦法：始終保持代碼的整潔靡狞。
寫整潔代碼就像是繪畫。多數(shù)人知道一幅畫是好是壞隔嫡，但能分辨優(yōu)劣并不表示懂得繪畫甸怕，能分辨代碼優(yōu)劣的人也不意味著會寫整潔代碼甘穿。
寫整潔代碼需要遵循大量的小技巧，貫徹刻苦習(xí)得的“整潔感”梢杭。這種“代碼感”就是關(guān)鍵所在温兼。
什么是整潔代碼
整潔的代碼只做好一件事。簡潔武契，優(yōu)雅募判。
每個函數(shù)、每個類咒唆、每個模塊都全神貫注于一事届垫，不受四周細(xì)節(jié)的干擾和污染。
有意義的命名
變量钧排、函數(shù)敦腔、參數(shù)、類恨溜、包、文件找前。有很多地方需要命名糟袁。怎么命名才能簡潔明了？
1. 名副其實(shí)
說起來簡單躺盛，但這是一個很嚴(yán)肅的問題项戴。選個好名字要花時間，但省下來的時間比花掉的多槽惫。一旦有好的命名周叮，就換掉舊的。
- 如果名稱需要注釋來補(bǔ)充界斜，那么說明名字沒取好仿耽。(不是名副其實(shí))
// 差的命名
int d; // 消逝的時間，以日計算各薇。
// 好的命名
int elapsedTimeInDays;
int daysSinceCreation;
int daysSinceModification;
int fileAgeInDays;
- 選擇體現(xiàn)本意的名稱能讓人更容易理解和修改代碼项贺。
public List<int[]> getThem() {
List<int[]> list1 = new ArrayList<int[]>();
for (int[] x : theList) {
if (x[0] == 4) {
list1.add(x);
}
}
return list1;
}
上面代碼雖然簡潔，但是我們能說清楚它到底做了啥嗎峭判？ 問題不在于代碼的簡潔度开缎，而是在于代碼的模糊度：即上下文在代碼中未被明確體現(xiàn)的程度。上面代碼要求我們了解類似一下問題的答案：
- theList中是什么類型的東西
- theList零下標(biāo)條目的意義是什么
- 值4的意義是什么
- 我怎么使用返回的列表
問題的答案沒體現(xiàn)在代碼段中林螃，而這本就是它們應(yīng)該在的地方奕删。比如，我們正在開發(fā)一款掃雷游戲疗认，我們發(fā)現(xiàn)盤面是名為theList的單元格列表完残，那就將其名稱改為gameBoard伏钠。
盤面上每個單元格都用一個簡單數(shù)組表示。我們還發(fā)現(xiàn)坏怪，零下標(biāo)條目是一種狀態(tài)的值贝润，而這種狀態(tài)值為4表示為“已標(biāo)記”。只要改為有意義的名稱铝宵，代碼就會得到相當(dāng)程度的改進(jìn)打掘。
public List<int[]> getFlaggedCells() {
List<int[]> flaggedCells = new ArrayList<>();
for (int[] cell : gameBoard) {
if (cell[STAUS_VALUE] == FLAGGED) {
flaggedCells.add(cell);
}
}
return flaggedCells;
}
還可以更進(jìn)一步，不用int數(shù)組表示單元格鹏秋，而是另寫一個類尊蚁。該類包括一個名副其實(shí)的函數(shù)（稱為isFlagged），從而掩蓋住那個魔術(shù)數(shù)（就是那個4）侣夷。于是得到函數(shù)的新版本：
public List<Cell> getFlaggedCells() {
List<Cell> flaggedCells = new ArrayList<>();
for (Cell cell : gameBoard) {
if (cell.isFlagged()) {
flaggedCells.add(cell);
}
}
return flaggedCells;
}
只要簡單改一下名字横朋，就能輕易知道發(fā)生了什么。這就是選好名字的力量
2. 避免誤導(dǎo)
程序員必須避免留下掩蓋代碼本意的錯誤線索百拓。應(yīng)當(dāng)避免使用與本意相悖的詞琴锭。例如，別用accountList來指稱一組賬號衙传，除非它真的是List類型（即便容器就是一個List决帖，最好也別在名稱中寫出容器類型名）。如果包含賬號的容器并非真是個List蓖捶，就會引起錯誤的判斷地回。所以，用accountGroup或bunchOfAccounts俊鱼，甚至直接用accounts都會好一些刻像。
提防使用不同之處較小的名稱。相區(qū)分模塊中某處的XYZControllerForEfficientHandlongOfStrings和另一處的XYZControllerForEfficientStorageOfStrings并闲，會花多長時間呢细睡？ 這兩個詞外形實(shí)在是太像了。
誤導(dǎo)性名稱真正可怕的例子是使用小寫的字母l和大寫的字母O作為變量名焙蚓，尤其是在組合使用的時候纹冤。問題在于，它倆看起來完全像是數(shù)字1和0购公。
3. 做有意義的區(qū)分
數(shù)字系列和廢話名稱萌京，可以滿足編譯器，但是遠(yuǎn)遠(yuǎn)不夠宏浩。
public static void copyChars(char[] a1, char[] a2) {
for (int i = 0; i < a1.length; i++) {
a2[i] = a1[1];
}
}
以數(shù)字系列命名(a1, a2, ......aN)是依義命名的對立面知残。這樣的名稱純屬誤導(dǎo)——完全沒有提供正確的信息，沒有提供導(dǎo)向作者意圖的線索比庄。
如果將參數(shù)名改為source和destination求妹，這個函數(shù)將會像樣很多乏盐。
廢話是另一種沒有意義的區(qū)分。假設(shè)你有一個Product類制恍。如果還有一個ProductInfo或ProductData類父能，那它們的名稱雖然不同，意思卻沒區(qū)別净神。Info和Data就像a何吝、an和the一樣，是意義含混的廢話鹃唯。
如果缺少明確約定爱榕，變量moneyAmout就與money沒區(qū)別，customerInfo與customer沒區(qū)別坡慌，accountData與account沒區(qū)別黔酥，theMessage也與message沒區(qū)別。要區(qū)分名稱洪橘，就要以讀者能鑒別不同之處的方式來區(qū)分跪者。
4. 使用讀的出來的名稱
能讀出來的名稱更容易記憶。如果名稱讀不出來熄求，討論的時候就像個傻鳥坑夯。
Date genymdhms // 生成日期，年抡四、月、日仗谆、時指巡、分、秒
Date generationTimestamp;
5. 使用可搜索的名稱
找MAX_CLASSES_PER_STUDENT比找數(shù)字7要容易得多隶垮。同樣字母e也不是個便于搜索的變量名藻雪。因?yàn)樘Ｒ娏恕?/p>
單字母名稱僅用于短方法中的局部變量。名稱長短應(yīng)與其作用域大小相對應(yīng)狸吞。如果變量或常量可能在代碼中多處使用勉耀，則應(yīng)賦予其以便于搜索的名字。
6. 避免將類型或作用域編進(jìn)名稱中
- 匈牙利語標(biāo)記法（Hungarian Notation,HN）
早期編譯器不做類型檢查蹋偏，程序員需要用匈牙利語標(biāo)記法（Hungarian Notation,HN）來幫助自己記住類型便斥。
在Windows的C語言API的時代，HN非常重要威始，傳說HN是為了紀(jì)念具有傳奇色彩的微軟程序員Charles Simonyi枢纠。這種標(biāo)記法比較簡單：即變量名以表明該變量數(shù)據(jù)類型的小寫字母開始。
例如szCmdLine的前綴sz代表string end of zero.以0 結(jié)尾的字符串黎棠。
strPhone,代表Phone是字符串類型晋渺。
而今镰绎，大部分語言是強(qiáng)類型的，代碼編輯環(huán)境都已經(jīng)先進(jìn)到在編譯開始前就偵測到類型錯誤的程度木西！所以HN和其他類似的格式編碼都多余了畴栖。
它們增加了修改變量，函數(shù)八千，或類的名稱或類型的難度吗讶。
PhoneNumber phoneString;
//類型變化時，名稱并未變化叼丑。
- 成員前綴
也不必用 m_ 前綴來標(biāo)明成員變量关翎。應(yīng)當(dāng)把類和函數(shù)做得足夠小，消除對成員前綴的需要鸠信。
- 接口和實(shí)現(xiàn)
接口前導(dǎo)字母I被濫用纵寝。
7. 類名應(yīng)該是名詞或名詞短語，方法名應(yīng)該是動詞或者動詞短語
類名如Customer星立、WikiPage爽茴、Account。避免使用Manager绰垂、Processor室奏、Data或Info這樣的類名
方法名如postPayment、deletePage或save劲装。屬性訪問器胧沫、修改器或斷言應(yīng)該根據(jù)其值命名，并依Javabean標(biāo)準(zhǔn)加上get占业、set和is前綴绒怨。
8. 同一概念對應(yīng)統(tǒng)一個詞
比如get、fetch谦疾、retrieve表達(dá)的含義差不多南蹂，盡量保持多個類使用同一種寫法。
Controller念恍、Manager六剥、Driver含義相近，盡量保持一致峰伙。
9. 不用雙關(guān)語
10. 使用解決方案領(lǐng)域名稱
代碼是給程序員讀的疗疟，用計算機(jī)領(lǐng)域類的術(shù)語來命名是一個很好的做法。比如AccountVisitor词爬、JobQueue這種秃嗜。
如果不能用程序員熟悉的術(shù)語來命名，就采用所涉問題的領(lǐng)域名稱命名。
11. 添加有意義的語境锅锨、不要添加沒用的語境
如果你有命名良好的類叽赊、函數(shù)或命名空間來放置名稱，給讀者提供語境是最好不過了必搞。如果沒有必指，就用最后一招———給名稱添加前綴。
比如恕洲，你有名為firstName塔橡、lastName、street霜第、hourseNumber葛家、city、state變量泌类，擱一塊兒的時候癞谒，很明確是一個地址。如果只是在一個方法中單獨(dú)的看到一個state變量呢刃榨，你會理所當(dāng)然得推斷是一個地址嗎弹砚？
可以添加前綴addrFirstName、addrLastName枢希、addrState來提供語境桌吃。
假設(shè)有一個名為“加油站豪華版”(Gas Station Deluxe)的應(yīng)用，在其中給每個類添加GSD前綴就不是什么好點(diǎn)子了苞轿。
