開発者のための命名規則ガイド

変数・関数・ファイルの名前の付け方は好みの問題に見えるかもしれませんが、実際にはチームの生産性やコードの読みやすさを左右するルールです。

なぜ命名規則が重要なのか

コードは書かれるよりもはるかに多く読まれます。一貫した命名規則があれば、他の人も、そして将来の自分も、コードをすばやく理解できます。

ルールが統一されていれば、名前を見るだけで変数なのか定数なのかクラスなのかが推測でき、無駄な検索を減らせます。

主なケース形式を一目で

• camelCase — 最初の単語は小文字、以降の単語の先頭は大文字（myVariableName）
• PascalCase — すべての単語の先頭を大文字（MyClassName）
• snake_case — すべて小文字で、単語をアンダースコアでつなぐ（my_variable_name）
• CONSTANT_CASE — すべて大文字＋アンダースコアで、主に定数に使う（MAX_COUNT）
• kebab-case — すべて小文字＋ハイフンで、主に URL や CSS に使う（my-class-name）

言語・文脈ごとの規則

多くの言語がそれぞれ独自の規則を推奨しています。Python は変数や関数に snake_case を好み、JavaScript や Java は camelCase を使い、ほとんどの言語がクラス名に PascalCase を用います。

定数は言語を問わず CONSTANT_CASE で書かれることが多く、URL のパスや CSS クラスでは kebab-case が事実上の標準になっています。

ルールよりも一貫性が大切

唯一絶対に正しい形式はありません。最も大切なのは、プロジェクトやチームで合意したルールを一貫して守ることです。

既存のコードベースに加わるときは、個人の好みよりもそのコードベースの規則を優先しましょう。多数の識別子を一括でリネームする必要があるときは、ケース変換ツールが役立ちます。