クリーンコードの命名原則:Robert C. Martinの教え
5 分で読了
Robert C. Martinの『クリーンコード』は、命名に丸ごと1章を割いています。ここでは主要な原則を紹介します。
基本ルール
- 意図を明かす名前を使う: 名前は、なぜ存在し何をするのかに答えるべきです
- 誤情報を避ける: リストでないものを「list」と呼ばない
- 意味のある区別をつける:
a1・a2ではなくsource・destination - 発音できる名前を使う:
genymdhmsではなくgenerationTimestamp - 検索できる名前を使う: マジックナンバーの代わりに名前付き定数を使う
- エンコーディングを避ける: ハンガリアン記法やメンバー接頭辞は使わない
- クラス名は名詞:
Customer,Account,AddressParser - メソッド名は動詞:
save(),deletePage(),postPayment()
名前を変換する
ケース変換ハブで、あらゆる規則に合わせて名前をフォーマットしましょう。