🎯 什麼情境該想到我
當你「函式的名字沒把意圖說清楚,或參數清單不理想」的時候——修改函式的名字或參數,讓這個介面更容易被理解與使用。改名是這其中最常用、也最有價值的動作。
⚙️ 怎麼用(步驟 / 公式)
意圖:改動函式的名字或參數,讓函式介面更好、更清楚地表達用途。
動作要點(小步安全進行):
- 簡單做法:改動不大、呼叫點不多時,直接改宣告、更新所有呼叫點、測試即可。
- 遷移式做法(migration,適合難一次改完或對外公開的 API):
- 若要調整本體,先把本體整理到能直接搬移的狀態。
- 用提煉函式 Extract Function把函式本體抽成一個具備「新宣告」的新函式。
- 讓舊函式改為呼叫新函式(形成過渡期,兩者並存)。
- 逐一把呼叫端改成呼叫新函式,每步測試。
- 全部遷移完後,用行內函式 Inline Function除掉舊函式,或直接刪除。
- 命名技巧:先想「假如已經寫好、理想的名字會是什麼」,再回頭改實作。
🧪 我實際套用的紀錄
- (待填)
⚠️ 注意 / 什麼時候不適用
- 對外公開、無法一次掌握所有呼叫端的 API,用遷移式做法逐步過渡,別硬改。
- 別為了改名而破壞既有語意;名字要反映真正的意圖。
🔗 相關工具
- 引入參數物件 Introduce Parameter Object(把一組常一起出現的參數整併,是改宣告的常見動機)
- 封裝變數 Encapsulate Variable(資料的存取介面版對應手法)
- 重構