クリーンコードの命名原則:Robert C. Martinの教え

5 分で読了

Robert C. Martinの『クリーンコード』は、命名に丸ごと1章を割いています。ここでは主要な原則を紹介します。

基本ルール

  • 意図を明かす名前を使う: 名前は、なぜ存在し何をするのかに答えるべきです
  • 誤情報を避ける: リストでないものを「list」と呼ばない
  • 意味のある区別をつける: a1a2ではなくsourcedestination
  • 発音できる名前を使う: genymdhmsではなくgenerationTimestamp
  • 検索できる名前を使う: マジックナンバーの代わりに名前付き定数を使う
  • エンコーディングを避ける: ハンガリアン記法やメンバー接頭辞は使わない
  • クラス名は名詞: Customer, Account, AddressParser
  • メソッド名は動詞: save(), deletePage(), postPayment()

名前を変換する

ケース変換ハブで、あらゆる規則に合わせて名前をフォーマットしましょう。