為變數、方法、其他實體選名稱,是軟體設計中最被低估的環節之一。

為什麼命名重要#

  • 好名稱本身就是一種文件——讓程式碼更易懂
  • 減少對其他文件的依賴
  • 讓錯誤更容易被發現
  • 反之,糟的名稱增加複雜性,造成歧義與誤解,導致 bug

命名是「複雜性是逐步累積」原則的縮影:

  • 單一變數名差一點點不會毀掉整個系統
  • 但軟體系統有上千個變數——所有名字都選好,會大幅改變整體可維護性

本章脈絡#

  1. 一個壞名字造成的真實 bug
  2. 為讀者創造意象
  3. 名稱要精確
  4. 命名要一致
  5. 不同的看法:Go 語言的短名稱風格
  6. 結語

結語#

好的命名讓程式碼顯而易見:讀者第一次遇到變數時,不需多想就能正確猜出它的行為。

選好名字是投資心態的展現:

  • 前期多花一點時間 → 未來工作更輕鬆、更少 bug
  • 「為命名磨練技巧」也是一種投資
    • 一開始放棄「差不多就好」的名字,會讓你覺得耗時挫折
    • 但隨經驗累積,挑好名字會變得越來越快、幾乎不需額外時間
    • 等到那一天,好命名的紅利幾乎變成免費的