易讀程式之美學：提升程式碼可讀性的簡單法則


	本書主題是介紹如何寫出有高度可讀性的程式碼，主要概念是程式碼必需易於理解，更精確地說，撰寫程式碼時應將他人理解程式碼所需的時間縮到最短。　　本書使用許多不同程式語言的範例解釋這個概念，包含了 C++、Python、JavaScript 以及 Java；避開了程式語言的進階特性，即使不熟悉這些程式語言的讀者，也能夠輕易理解內容（畢竟，可讀性概念大多與程式語言本身無關）。　　本書各章節由程式設計的不同層面說明如何讓程式「更易於理解」，共分為四個部份；　　表層改善　　名稱、註解與美學：使用在每一行程式碼的簡單技巧。　　簡化迴圈與邏輯　　透過改善程式的迴圈、邏輯與變數，提高可讀性的方法。　　重新組織程式碼　　組織大區塊程式以及從函數層面解決問題的高階作法。　　精選主題　　將「易於理解」原則應用在測試以及大型資料結構的程式。作者簡介 Dustin Boswell 　　畢業於 CalTech，任職於 Google 五年，負責網頁抓取基礎設施（web crawling infrastructure）以及廣告相關程式。他建立了多個網站，喜歡海量資料與機器學習等領域。 Trevor Foucher 　　曾任職於微軟十餘年，擔任 Windows 與安全相關產品的工程師、經理以及技術負責人，目前任職於 Google 負責廣告程式與搜尋基礎設施。


	目錄前言 1 程式碼應該易於理解「更好」的意義？可讀性基本定理比較短的程式都比較好嗎？最短理解所需時間與其他目標是否衝突困難所在第一部份表層改善 2 富含資訊的名稱選擇詞彙避免 tmp 與 retval 之類的通用名稱優先使用具體名稱而非抽象名稱在名稱中加入額外資訊名稱該有多長？利用名稱格式加入更多意義結語 3 不被誤解的名稱範例：Filter() 範例：Clip(text, length) 包含邊界的極值優先使用 min 與 max 閉區間優先使用 first 與 last 半開放開區間優先使用 begin 與 end 布林值名稱符合使用者的預期範例：評估多個可用名稱結語 4 美學美學為何重要？調整斷行讓程式更加一致與簡潔使用方法（method）消除混亂適當使用列對齊選擇有意義的順序並堅守到底將宣告組織成區塊區分程式碼「段落」個人風格與一致性結語 5 認識註解不該註解的部份記錄自己的想法為讀者設想最後 - 避免作者區塊結語 6 讓註解精確與簡潔維持註解簡潔避免模稜兩可的代名詞修整草率的語句精確描述函數行為使用具代表性的輸入∕輸出範例表達程式意圖「函數參數名稱」的註解使用訊息密集的詞彙結語第二部份簡化迴圈與邏輯 7 提高控制流程可讀性條件式中的條件順序 if/else 區塊順序 □: 條件式（也稱為「三元運算子」）避免 do/while 迴圈儘早由函數中返回惡名昭彰的 goto 減少巢狀結構能否理解執行流程？結語 8 分解巨大表示式解釋性變數摘要變數利用笛摩根定律誤用捷徑邏輯範例：與複雜邏輯搏鬥分解巨大的敘述另一個有創意的簡化手法結語 9 變數與可讀性消除變數縮限變數的範圍（scope）偏好單次寫入的變數最後的範例結語第三部份重新組織程式碼 10 抽離不相關子問題說明範例：findClosestLocation() 純工具程式碼其他通用程式碼建立大量通用程式碼專案專屬功能簡化既有介面依需求重塑介面過猶不及結語 11 一次一項工作工作可以很小從物件抽取數值較大的範例結語 12 將想法轉化為程式碼清述描述邏輯認識函式庫能提供的協助在較大問題應用本方法結語 13 撰寫較少程式碼不開發那些功能 - 不會需要詢問與分解需求維持程式碼小而美熟悉使用的函式庫範例：用 Unix 工具代替撰寫程式結語第四部份精選主題 14 測試與可讀性讓測試易讀與維護這些測試有何問題？讓測試更易讀讓錯誤訊息易讀選擇良好的測試輸入測試函數的命名那些測試有何問題？測試友善的開發過度應用本原則結語 15 「分∕時計數器」的設計與實作問題說明定義類別介面第一次嚐試：粗略的解決方案第二次嚐試：輸送帶式設計第三次嚐試：時間區段（Time-Bucketed）設計比較三種解決方案結語 A 延伸閱讀索引