### Comments（過多的注釋）
別擔心，我們并不是說你不該寫注釋。從嗅覺上說，Comments不是一種壞味道；事實上它們還是一種香味呢。我們之所以要在這里提到Comments，因為人們常把它當作除臭劑來使用。常常會有這樣的情況：你看到一段代碼有著長長的注釋，然后發現，這些注釋之所以存在乃是因為代碼很糟糕。這種情況的發生次數之多，實 在令人吃驚。
Comments可以帶我們找到本章先前提到的各種壞味道。找到壞味道后，我們首先應該以各種重構手法把壞味道去除。完成之后我們常常會發現：注釋已經變得多余了，因為代碼已經清楚說明了一切。
如果你需要注釋來解釋一塊代碼做了什么，試試 Extract Method；如果method已經提煉出來，但還是需要注釋來解釋其行為，試試Rename Method；如果你需要注釋說明某些系統的需求規格，試試 Introduce Assertion。
TIP：當你感覺需要撰寫注釋，請先嘗試重構，試著讓所有注釋都變得多余。
如果你不知道該做什么，這才是注釋的良好運用時機。除了用來記述將來的打算之外，注釋還可以用來標記你并無十足把握的區域。你可以在注釋里寫下自己「為什 么做某某事」。這類信息可以幫助將來的修改者，尤其是那些健忘的家伙。
- 譯序 by 侯捷
- 譯序 by 熊節
- 序言
- 前言
- 章節一 重構，第一個案例
- 起點
- 重構的第一步
- 分解并重組statement()
- 運用多態（Polymorphism）取代與價格相關的條件邏輯
- 結語
- 章節二 重構原則
- 何謂重構
- 為何重構
- 「重構」助你找到臭蟲(bugs)
- 何時重構
- 怎么對經理說？
- 重構的難題
- 重構與設計
- 重構與性能（Performance）
- 重構起源何處？
- 章節三 代碼的壞味道
- Duplicated Code（重復的代碼）
- Long Method（過長函數）
- Large Class（過大類）
- Long Parameter List（過長參數列）
- Divergent Change（發散式變化）
- Shotgun Surgery（散彈式修改）
- Feature Envy（依戀情結）
- Data Clumps（數據泥團）
- Primitive Obsession（基本型別偏執）
- Switch Statements（switch驚悚現身）
- Parallel Inheritance Hierarchies（平行繼承體系）
- Lazy Class（冗贅類）
- Speculative Generality（夸夸其談未來性）
- Temporary Field（令人迷惑的暫時值域）
- Message Chains（過度耦合的消息鏈）
- Middle Man（中間轉手人）
- Inappropriate Intimacy（狎昵關系）
- Alternative Classes with Different Interfaces（異曲同工的類）
- Incomplete Library Class（不完美的程序庫類）
- Data Class（純稚的數據類）
- Refused Bequest（被拒絕的遺贈）
- Comments（過多的注釋）
- 章節四 構筑測試體系
- 自我測試代碼的價值
- JUnit測試框架
- 添加更多測試
- 章節五 重構名錄
- 重構的記錄格式
- 尋找引用點
- 這些重構準則有多成熟
- 章節六 重新組織你的函數
- Extract Method（提煉函數）
- Inline Method（將函數內聯化）
- Inline Temp（將臨時變量內聯化）
- Replace Temp with Query（以查詢取代臨時變量）
- Introduce Explaining Variable（引入解釋性變量）
- Split Temporary Variable（剖解臨時變量）
- Remove Assignments to Parameters（移除對參數的賦值動作）
- Replace Method with Method Object（以函數對象取代函數）
- Substitute Algorithm（替換你的算法）
- 章節七 在對象之間搬移特性
- Move Method（搬移函數）
- Move Field（搬移值域）
- Extract Class（提煉類）
- Inline Class（將類內聯化）
- Hide Delegate（隱藏「委托關系」）
- Remove Middle Man（移除中間人）
- Introduce Foreign Method（引入外加函數）
- Introduce Local Extension（引入本地擴展）
- 章節八 重新組織數據
- Self Encapsulate Field（自封裝值域）
- Replace Data Value with Object（以對象取代數據值）
- Change Value to Reference（將實值對象改為引用對象）
- Replace Array with Object（以對象取代數組）
- Replace Array with Object（以對象取代數組）
- Duplicate Observed Data（復制「被監視數據」）
- Change Unidirectional Association to Bidirectional（將單向關聯改為雙向）
- Change Bidirectional Association to Unidirectional（將雙向關聯改為單向）
- Replace Magic Number with Symbolic Constant（以符號常量/字面常量取代魔法數）
- Encapsulate Field（封裝值域）
- Encapsulate Collection（封裝群集）
- Replace Record with Data Class（以數據類取代記錄）
- Replace Type Code with Class（以類取代型別碼）
- Replace Type Code with Subclasses（以子類取代型別碼）
- Replace Type Code with State/Strategy（以State/strategy 取代型別碼）
- Replace Subclass with Fields（以值域取代子類）
- 章節九 簡化條件表達式
- Decompose Conditional（分解條件式）
- Consolidate Conditional Expression（合并條件式）
- Consolidate Duplicate Conditional Fragments（合并重復的條件片段）
- Remove Control Flag（移除控制標記）
- Replace Nested Conditional with Guard Clauses（以衛語句取代嵌套條件式）
- Replace Conditional with Polymorphism（以多態取代條件式）
- Introduce Null Object（引入Null 對象）
- Introduce Assertion（引入斷言）
- 章節十一 處理概括關系
- Pull Up Field（值域上移）
- Pull Up Method（函數上移）
- Pull Up Constructor Body（構造函數本體上移）
- Push Down Method（函數下移）
- Push Down Field（值域下移）
- Extract Subclass（提煉子類）
- Extract Superclass（提煉超類）
- Extract Interface（提煉接口）
- Collapse Hierarchy（折疊繼承關系）
- Form Template Method（塑造模板函數）
- Replace Inheritance with Delegation（以委托取代繼承）
- Replace Delegation with Inheritance（以繼承取代委托）
- 章節十二 大型重構
- 這場游戲的本質
- Tease Apart Inheritance（梳理并分解繼承體系）
- Convert Procedural Design to Objects（將過程化設計轉化為對象設計）
- Separate Domain from Presentation（將領域和表述/顯示分離）
- Extract Hierarchy（提煉繼承體系）
- 章節十三 重構，復用與現實
- 現實的檢驗
- 為什么開發者不愿意重構他們的程序？
- 現實的檢驗（再論）
- 重構的資源和參考資料
- 從重構聯想到軟件復用和技術傳播
- 結語
- 參考文獻
- 章節十四 重構工具
- 使用工具進行重構
- 重構工具的技術標準（Technical Criteria ）
- 重構工具的實用標準（Practical Criteria ）
- 小結
- 章節十五 集成
- 參考書目