Refactoring重構教學
Refactoring(重構)教學手冊 文件版本:v2.0(2026-10-13) 作者:資深軟體架構師團隊 適用對象:Java/TypeScript 開發人員、Tech Lead、程式碼審查者、使用 AI 程式助理的工程師 技術基準:Java 25 LTS、JUnit 6、Maven 3.9、TypeScript 6/7、IntelliJ IDEA 2026.2(詳見 0.3) 定位:教學手冊——以「把人教會」為目標,每個觀念都有逐步操作、可執行的範例與練習;規則以 RFT-* 編號,可直接當作審查 AI 產出的檢核依據 目錄 0. 文件資訊與學習指南 0.1 為什麼要學重構 0.2 讀者與學習路徑 0.3 技術基準版本 0.4 規則格式與驗證圖示 0.5 範例的閱讀方式 0.6 與其他文件的關係 0.7 名詞約定 1. 重構基本概念 1.1 什麼是重構 1.2 可觀察行為的界定 1.3 重構的目標與效益 1.4 重構與其他變更的區別 1.5 國際標準與業界參考 1.6 實務案例:一次「不是重構」的重構 2. 重構的基本原則 2.1 兩頂帽子 2.2 小步前進與每步驗證 2.3 重構的時機 2.4 何時不該重構 2.5 安全重構的流程 2.6 Tidy First:整理的經濟學 2.7 實務注意事項 3. 識別壞味道(Code Smells) 3.1 什麼是程式碼壞味道 3.2 Fowler 第二版的 24 種壞味道 3.3 膨脹類壞味道 3.3.1 過長函式(Long Function) 3.3.2 過長參數列(Long Parameter List) 3.3.3 過大類別(Large Class) 3.3.4 資料泥團與基本型別偏執(Data Clumps/Primitive Obsession) 3.4 阻礙修改類壞味道 3.5 耦合類壞味道 3.6 可有可無類壞味道與註解 3.7 資料與狀態類壞味道 3.8 壞味道的量化指標 3.9 壞味道識別工具 3.9.1 靜態分析工具 3.9.2 IDE 內建工具 4. 基本重構手法 4.1 提煉函式與內聯函式(Extract Function/Inline Function) 4.2 提煉變數與內聯變數(Extract Variable/Inline Variable) 4.3 改名(Rename Variable/Rename Field) 4.4 改變函式宣告(Change Function Declaration) 4.5 引入參數物件(Introduce Parameter Object) 4.6 封裝變數、以查詢取代暫存變數與拆分變數 4.7 搬移語句與拆分迴圈(Slide Statements/Split Loop) 4.8 以具名常數取代魔術字面值(Replace Magic Literal) 4.9 拆分階段與函式組合(Split Phase/Combine Functions into Class) 4.10 以命令取代函式(Replace Function with Command) 4.11 重構方法選擇流程 4.11.1 重構決策樹 4.11.2 重構優先順序指南 5. 搬移特性與組織資料 5.1 搬移函式(Move Function) 5.2 搬移欄位(Move Field) 5.3 提煉類別與內聯類別(Extract Class/Inline Class) 5.4 隱藏委託與移除中間人(Hide Delegate/Remove Middle Man) 5.5 以物件取代基本型別(Replace Primitive with Object) 5.6 移除無用程式碼(Remove Dead Code) 5.7 封裝集合與封裝記錄(Encapsulate Collection/Encapsulate Record) 5.8 值物件與參照物件、以查詢取代衍生變數 6. 簡化條件邏輯 6.1 分解條件式(Decompose Conditional) 6.2 合併條件式(Consolidate Conditional Expression) 6.3 以衛述句取代巢狀條件式(Replace Nested Conditional with Guard Clauses) 6.4 以多型取代條件式(Replace Conditional with Polymorphism) 6.5 引入特例(Introduce Special Case) 6.6 引入斷言與以 break 取代控制旗標 7. API 與繼承重構 7.1 將查詢與修改分離(Separate Query from Modifier) 7.2 移除旗標參數與函式參數化(Remove Flag Argument/Parameterize Function) 7.3 保留完整物件與以查詢取代參數(Preserve Whole Object/Replace Parameter with Query) 7.4 以工廠函式取代建構式(Replace Constructor with Factory Function) 7.5 以例外取代錯誤碼(Replace Error Code with Exception) 7.6 繼承結構重構:上移、下移、提煉父類別與摺疊階層 7.7 以委託取代繼承(Replace Superclass/Subclass with Delegate) 7.8 公開函式庫的相容性檢查 8. 重構與測試:建立安全網 8.1 重構的安全網:為什麼測試是前提 8.2 特性測試(Characterization Test) 8.3 核准測試(Approval Test) 8.4 覆蓋率與變異測試 8.4.1 覆蓋率的意義與限制 8.4.2 用變異測試檢查安全網 8.5 重構友善的測試設計 8.6 等價性驗證:同一組測試驗證重構前後 8.7 重構測試檢查清單 9. TDD 與重構 9.1 紅燈—綠燈—重構循環詳解 9.2 實際 TDD 重構範例 9.3 重構測試程式碼 10. 遺留程式碼的重構 10.1 遺留程式碼變更演算法 10.2 接縫(Seam) 10.3 Sprout 與 Wrap:讓新程式碼保持可測試 10.4 打破相依的常用手法 10.5 Mikado 方法 10.6 探索性重構(Scratch Refactoring) 11. 大型與架構層級的重構 11.1 漸進式重構與大爆炸重寫 11.2 Strangler Fig 與平行執行 11.3 Branch by Abstraction 11.4 架構守護:用 ArchUnit 把規則寫成測試 11.5 功能旗標的生命週期 12. 資料庫與 API 的演進式重構 12.1 為什麼不能一次改名 12.2 擴充—遷移—收縮(Expand–Migrate–Contract) 12.3 API 的演進 12.4 事件與訊息格式的演進 13. Java 現代化重構 13.1 現代化的原則 13.2 sealed 型別與模式比對 switch 13.3 以 record 取代資料類別 13.4 以管線取代迴圈(Replace Loop with Pipeline) 13.5 Optional 的使用 13.6 文字區塊與其他語法 13.7 用 OpenRewrite 自動化現代化 14. 前端 TypeScript 重構 14.1 TypeScript 重構的安全網 14.2 以可辨識聯集取代型別碼 14.3 || 與 ??、&& 與 ?. 的差異 14.4 Promise 鏈改寫為 async/await 14.5 以 unknown 取代 any 14.6 以 codemod 進行大量修改 15. 重構工具與自動化 15.1 IDE 的自動化重構 15.2 靜態分析與品質門檻 15.3 CI 中的重構守護 15.4 編譯器警告與棄用追蹤 15.5 RefactoringMiner:在審查時辨識重構 15.6 工具選擇與配置 16. 效能與重構 16.1 重構與效能的關係 16.2 用 JMH 量測 16.3 效能監控與回歸 16.4 重構常見的效能退化 17. 團隊規範與最佳實務 17.1 重構的責任分配與協作 17.2 提交與 PR 的規範 17.3 程式碼審查中的重構 17.3.1 審查檢查清單 17.3.2 審查技巧:辨識搬移的程式碼 17.4 重構標準與約定 17.4.1 命名規範 17.4.2 程式碼組織約定 17.5 持續重構的團隊文化 17.5.1 重構意識培養 17.5.2 工具與流程整合 17.5.3 團隊重構最佳實務 17.6 重構培訓計畫 17.6.1 新人重構訓練 17.6.2 技能評估標準 18. AI 輔助重構 18.1 AI 輔助重構的機會與風險 18.2 給 AI 的重構提示 18.3 專案層級的 AI 指示檔 18.4 驗證 AI 產出的流程 18.5 AI 常見的重構錯誤 18.6 AI 代理的批次重構 19. 技術債管理與重構的度量 19.1 技術債與技術債象限 19.2 技術債登錄 19.3 熱點分析:決定先重構哪裡 19.4 重構的時機與投資配置 19.4.1 主動重構與被動重構 19.4.2 重構優先順序矩陣 19.4.3 容量配置 19.5 重構效益的評估與度量 20. 重構的反模式與常見陷阱 20.1 流程上的反模式 20.2 程式碼上的反模式 20.3 測試上的反模式 20.4 AI 協作的反模式 21. 綜合案例:活動票券對帳單 21.1 起點:需求與現有程式碼 21.2 建立安全網 21.3 重構步驟 21.4 重構後的程式碼 21.5 加入新功能 22. 練習與自我評量 22.1 能力評量架構 22.1.1 觀念能力 22.1.2 實作能力 22.2 觀念選擇題 22.3 情境分析題 22.4 程式碼重構實作題 22.4.1 Kata 1:會員點數(Java) 22.4.2 Kata 2:價格標籤(TypeScript) 22.5 AI 產出審查演練 22.6 綜合演練 22.7 評分基準 22.8 學習建議 23. 檢查清單 23.1 重構前檢查清單 23.1.1 環境準備 23.1.2 範圍評估 23.2 重構執行檢查清單 23.2.1 執行原則 23.2.2 常見重構步驟 23.3 重構後檢查清單 23.3.1 功能驗證 23.3.2 品質檢查 23.3.3 交付準備 23.4 緊急應對檢查清單 23.4.1 問題發現 23.4.2 修復策略 23.5 持續改善檢查清單 23.5.1 定期檢視 23.5.2 工具和流程優化 23.6 AI 產出審查檢查清單 附錄 A 規則總表 A.1 依領域統計 A.2 驗證方式與範例覆蓋 A.3 規則清單 附錄 B 手法速查表 B.1 Fowler 第二版重構目錄對照 B.2 依壞味道查手法 B.3 IDE 快捷鍵速查 附錄 C 設定檔與腳本 C.1 範例專案的 pom.xml C.2 PMD 規則集 C.3 Checkstyle 設定 C.4 GitHub Actions:重構型 PR 的守護流程 C.5 equivalence-check.sh C.6 refactor-guard.sh C.7 重構提案範本 附錄 D 名詞對照 附錄 E 參考資料 E.1 延伸閱讀:書籍 E.2 國際標準與規範 E.3 研究報告 E.4 線上資源 E.5 工具推薦 附錄 F 修訂紀錄與查證紀錄 F.1 v1.0 章節對照 F.2 v1.0 內容更正紀錄 F.3 查證紀錄 F.4 待確認事項 F.5 技術版本紀錄 0. 文件資訊與學習指南 0.1 為什麼要學重構 重構(refactoring)是「在不改變軟體可觀察行為的前提下,改善其內部結構」的一連串小步驟。它是每位工程師每天都在做的事,卻也最容易做錯: ...