変数の命名方法:読みやすいコードのための開発者ガイド
6 分で読了
変数命名はプログラマーが最も頻繁に行う設計判断です。良い名前はコードを自己文書化し、悪い名前はロジックの解読を強います。
基本原則
- 意図を明らかにする:
dではなくelapsedTimeInDays - 誤解を招かない: 実際はセットなのに
accountListと名付けない - 発音可能な名前を使う:
genymdhmsではなくgenerationTimestamp - 検索可能な名前を使う:
7ではなくMAX_STUDENTS_PER_CLASS
型別の命名パターン
| 型 | パターン | 例 |
|---|---|---|
| Boolean | is/has/can/should + 形容詞 | isActive、hasPermission |
| カウンター | 名詞 + Count/Total | retryCount、totalItems |
| コレクション | 複数形の名詞 | users、selectedItems |
| 関数 | 動詞 + 名詞 | calculateTotal、fetchUser |
| イベントハンドラー | handle/on + イベント | handleClick、onSubmit |
アンチパターン
data、info、temp、stuff— 曖昧すぎるa、b、x— ラムダや数式でのみ許容flag— 何のフラグ?代わりにisEnabledを使う- ハンガリアン記法(
strName、intAge) — モダンIDEでは時代遅れ
名前をフォーマット
JavaScriptにはcamelCaseコンバーター、Pythonにはsnake_caseコンバーター、またはケースコンバーターハブをご利用ください。