🎯 什麼情境該想到我
當你在替變數/函式/類別取名字,或看到一堆 d、tmp、data 看不懂時。
⚙️ 怎麼用
- 名字要能回答:它是什麼、為何存在、怎麼用。看到名字就不用再看註解。
- 用可讀、可搜尋的名字:
elapsedTimeInDays勝過d;避免單字母(迴圈計數例外)。 - 別用誤導性名字、別加型別雜訊(匈牙利命名法過時)。
- 類別用名詞、函式用動詞;同一概念用同一個字(別 fetch/get/retrieve 混用)。
🧪 我實際套用的紀錄
- 2026-07-14:(待填)
⚠️ 注意
- 想不到好名字,往往代表那段職責不清 → 該先釐清設計,命名是設計的鏡子。
🔗 相關工具
- 工具-函式短小且單一職責 —— 取不出好名字通常是職責不清;把函式切到只做一件事,名字往往自己浮出來
- 工具-縮小變數作用域 —— 降低閱讀心智負擔的另一半:作用域夠小時,短名字不但無妨還更好讀