🔧 重構

🎯 什麼情境該想到我

當你覺得某段程式碼「怪怪的、很髒」但講不出具體問題，或想判斷「該從哪裡開始重構」時。

⚙️ 怎麼用（把直覺變成可指認的清單）

常見壞味道 → 對應重構方向：

• 重複程式碼 → 提煉並共用
• 過長函式 / 過大類別 → 拆小（工具-提煉函式）
• 過長參數列 → 包成物件
• 發散式變化（一個類別因多種原因而改）/ 散彈式修改（一個改動要動很多處）→ 重新歸位職責
• 依戀情結（方法愛用別的類別資料）→ 搬移函式
• 資料泥團 / 基本型別偏執 / 過度耦合的訊息鏈

🧪 我實際套用的紀錄

• 2026-07-14：（待填）

⚠️ 注意

• 聞到味道不代表一定要立刻改；權衡成本與風險，並確保有測試。

🔗 相關工具

• 工具-小步重構 —— 聞到味道之後的行動節奏，一次改一小塊
• 工具-提煉函式 —— 對付最常見那幾種味道（過長函式、重複程式碼）的主力手法

🎯 什麼情境該想到我

當你想改善程式結構、卻怕一改就壞掉時。

⚙️ 怎麼用

1. 先確保有可靠測試（沒有就先補；見 工具-特徵測試）。
2. 每次只做一個小改動（一個標準重構手法）。
3. 每步都跑測試：綠燈才繼續，紅燈就退回上一步。
4. 提交要頻繁：小步可回溯，出錯損失小。
5. 重構與加功能分開做（別同時戴兩頂帽子）。

🧪 我實際套用的紀錄

• 2026-07-14：（待填）

⚠️ 注意

• 沒測試就大改＝走鋼索。先建立安全網再動手。

🔗 相關工具

• 工具-程式碼壞味道 —— 起點，決定這次小步要動哪裡
• 工具-提煉函式 —— 最常用的那一小步，多數重構是它的反覆施展
• 工具-特徵測試 —— 安全網，舊碼沒有測試時先補這個才敢動

🎯 什麼情境該想到我

當你有一段程式碼「可以獨立命名、說明它在做什麼」，或想拆長函式、消重複時。最常用的重構手法。

⚙️ 怎麼用

1. 找出一段內聚的程式碼（常是「這段在算 X」）。
2. 抽成新函式，用意圖命名（名字說「做什麼」而非「怎麼做」）。
3. 把用到的區域變數當參數傳入，回傳需要的結果。
4. 原處改成呼叫新函式，跑測試確認行為不變。

好處：消除重複、讓函式各層抽象一致、用函式名取代解釋性註解。

🧪 我實際套用的紀錄

• 2026-07-14：（待填）

⚠️ 注意

• 若抽出後參數爆多，代表切點不對或該連資料一起搬（考慮搬移到別的類別）。

🔗 相關工具

• 工具-函式短小且單一職責 —— 提煉的收手判準：抽到「一個函式只做一件事」為止，回答「要拆到多細」
• 工具-小步重構 —— 提煉要在測試保護下一小步一小步做，這張講怎麼保證每一步都沒改到行為
• 工具-註解是必要之惡 —— 「有註解在解釋這段 code」正是該提煉的訊號：用函式名取代那句註解