為變數、方法、其他實體選名稱,是軟體設計中最被低估的環節之一。
為什麼命名重要#
- 好名稱本身就是一種文件——讓程式碼更易懂
- 減少對其他文件的依賴
- 讓錯誤更容易被發現
- 反之,糟的名稱增加複雜性,造成歧義與誤解,導致 bug
命名是「複雜性是逐步累積」原則的縮影:
- 單一變數名差一點點不會毀掉整個系統
- 但軟體系統有上千個變數——所有名字都選好,會大幅改變整體可維護性
本章脈絡#
- 一個壞名字造成的真實 bug
- 為讀者創造意象
- 名稱要精確
- 命名要一致
- 不同的看法:Go 語言的短名稱風格
- 結語
結語#
好的命名讓程式碼顯而易見:讀者第一次遇到變數時,不需多想就能正確猜出它的行為。
選好名字是投資心態的展現:
- 前期多花一點時間 → 未來工作更輕鬆、更少 bug
- 「為命名磨練技巧」也是一種投資
- 一開始放棄「差不多就好」的名字,會讓你覺得耗時挫折
- 但隨經驗累積,挑好名字會變得越來越快、幾乎不需額外時間
- 等到那一天,好命名的紅利幾乎變成免費的