🎯 什麼情境該想到我

當你「函式的名字沒把意圖說清楚,或參數清單不理想」的時候——修改函式的名字或參數,讓這個介面更容易被理解與使用。改名是這其中最常用、也最有價值的動作。

⚙️ 怎麼用(步驟 / 公式)

意圖:改動函式的名字或參數,讓函式介面更好、更清楚地表達用途。

動作要點(小步安全進行):

  • 簡單做法:改動不大、呼叫點不多時,直接改宣告、更新所有呼叫點、測試即可。
  • 遷移式做法(migration,適合難一次改完或對外公開的 API):
    1. 若要調整本體,先把本體整理到能直接搬移的狀態。
    2. 提煉函式 Extract Function把函式本體抽成一個具備「新宣告」的新函式。
    3. 讓舊函式改為呼叫新函式(形成過渡期,兩者並存)。
    4. 逐一把呼叫端改成呼叫新函式,每步測試。
    5. 全部遷移完後,用行內函式 Inline Function除掉舊函式,或直接刪除。
  • 命名技巧:先想「假如已經寫好、理想的名字會是什麼」,再回頭改實作。

🧪 我實際套用的紀錄

  • (待填)

⚠️ 注意 / 什麼時候不適用

  • 對外公開、無法一次掌握所有呼叫端的 API,用遷移式做法逐步過渡,別硬改。
  • 別為了改名而破壞既有語意;名字要反映真正的意圖。

🔗 相關工具