テキスト・データ

キャメルケース・スネークケースの違い|ケバブケースも含めた命名規則の使い分け

ほかの言語で読む: 한국어

キャメルケースとスネークケースの違いは、単語の区切り方です。キャメルケースは userId のように2語目以降の先頭を大文字にして区切ります。スネークケースは user_id のように小文字の単語をアンダースコア(_)でつなぎます。

どちらが優れているかという話ではありません。使う言語や場所ごとに「ここではこの書き方」という慣習があります。プログラムの変数名やデータベースの項目名、URLにはたいていスペースを入れられないため、複数の単語をどうつなぐかというルールが必要です。このルールを命名規則といいます。

この記事では「user id」という同じ名前を例に5種類の書き方を比べます。そのうえで、Python・JavaScript・CSS・データベース・URLでの使い分け、略語や数字の扱い、書き方が混ざったときの失敗例、まとめて変換する手順まで整理します。

キャメルケースとスネークケースの違いを「user id」で比べる

よく使われる5つの書き方を、同じ「user id」で並べると次のとおりです。

名称 「user id」の書き方 区切り方 よく使われる場所
キャメルケース(camelCase) userId 2語目以降の先頭を大文字にする JavaScriptの変数・関数
パスカルケース(PascalCase) UserId すべての語の先頭を大文字にする クラス名・型名
スネークケース(snake_case) user_id 小文字をアンダースコアでつなぐ Pythonの変数・関数、DBのカラム名
大文字スネークケース(UPPER_SNAKE_CASE) USER_ID 大文字をアンダースコアでつなぐ 定数
ケバブケース(kebab-case) user-id 小文字をハイフンでつなぐ CSSのクラス名、URL

呼び方の別名

キャメルケースは、大文字の部分がラクダのこぶのように見えることからこう呼ばれます。先頭が小文字の userId を「ローワーキャメルケース」、先頭も大文字の UserId を「アッパーキャメルケース」と呼び分けることもあります。アッパーキャメルケースはパスカルケースと同じものです。

大文字スネークケースは「コンスタントケース」とも呼ばれます。ケバブケースは、単語が串に刺さったように見えることが名前の由来です。

ケバブケースが変数名に使えない理由

多くのプログラミング言語では、user-id は「user から id を引く」という引き算として解釈されます。そのためケバブケースは変数名や関数名には使えません。主に使われるのは、CSSやURL、ファイル名など、コードの外側の名前です。

Pythonの命名規則(PEP 8)ではスネークケースが基本

Pythonには、PEP 8という公式のコーディングスタイルガイドがあります。PEP 8で推奨されている書き方は次のとおりです。

対象 書き方 例
変数・関数 スネークケース user_id、get_user_id()
クラス パスカルケース(PEP 8では「CapWords」と呼ぶ) UserAccount
定数 大文字スネークケース MAX_RETRY_COUNT
モジュール(.pyファイル) 短い小文字。読みやすくなるならアンダースコアも可 user_profile.py

PEP 8はあくまでガイドなので、従わなくてもPythonがエラーを出すことはありません。PEP 8自身も、プロジェクト内で一貫していることのほうが大切で、1つのモジュールや関数の中での一貫性が最も大切だとしています。

実際、Pythonの標準ライブラリにも logging.getLogger() のようにキャメルケースの古い名前が残っています。既存のプロジェクトがキャメルケースで書かれているなら、無理に書き換えず、それに合わせるのが基本です。

JavaScriptはキャメルケースが中心

JavaScriptでは、変数と関数はキャメルケース、クラスはパスカルケースで書くのが一般的です。

const userId = 42;                  // 変数:キャメルケース
function getUserId() { /* ... */ }  // 関数:キャメルケース
class UserAccount { /* ... */ }     // クラス:パスカルケース
const MAX_RETRY_COUNT = 3;          // 固定の設定値:大文字スネークケース

標準で用意されている機能も、getElementById、toUpperCase、encodeURIComponent はキャメルケース、Date や Promise はパスカルケースです。自分で付ける名前もこれに揃えると、コード全体の見た目が統一されます。

const で宣言した変数をすべて大文字にするわけではありません。大文字スネークケースは、設定値のように「プログラム全体で固定の値」に使う慣習です。また、Reactのコンポーネント名は大文字で始める決まりがあります。小文字で始めると、HTMLのタグとして扱われてしまいます。

JSONやAPIのキー名は相手の仕様に合わせる

JSONの仕様では、キー名の書き方は決められていません。そのため、APIによって {"userId": 1} のものもあれば {"user_id": 1} のものもあります。

JavaScriptで存在しないキーを読むと、エラーではなく undefined が返ります。キー名の書き方を間違えても気づきにくいので、APIのドキュメントで正確な表記を確認してください。

CSSのクラス名・データベースのカラム名・URLの書き方

CSSはケバブケースが標準

CSSのプロパティ名は background-color や font-size のようにケバブケースで書きます。そのため、クラス名も .user-card のようにケバブケースにするのが一般的です。BEMという設計手法では、.user-card__name--active のようにアンダースコア2つとハイフン2つで要素や状態を表します。

JavaScriptからCSSやHTMLの属性を扱うと、ケバブケースがキャメルケースに変わります。background-color は element.style.backgroundColor になり、HTMLの data-user-id 属性は element.dataset.userId で読み取ります。2つの書き方が対応していることを知っておくと、混乱しにくくなります。

データベースは小文字のスネークケースが無難

データベースのカラム名(列名)は、user_id や created_at のようなスネークケースがよく使われます。大文字を混ぜると、製品によっては思わぬ動きをするためです。

たとえばPostgreSQLでは、引用符で囲まない名前は小文字に変換されます。

CREATE TABLE users (UserId integer);  -- 実際の列名は userid になる
SELECT "UserId" FROM users;           -- 列が見つからずエラー

引用符付きの "UserId" で作った場合は、以後ずっと引用符付きで書かなければなりません。MySQLでは、テーブル名の大文字・小文字を区別するかどうかがOSや設定によって変わります。小文字のスネークケースにしておけば、どちらの問題も避けられます。

URLは小文字のケバブケース

URLのパスは /blog/user-id-guide/ のように、小文字のケバブケースにするのが一般的です。Googleの検索に関するドキュメントでも、URL内の単語の区切りにはアンダースコアよりハイフンを使うよう推奨しています。

URLのドメイン部分は大文字・小文字を区別しません。一方、パス部分はサーバーによって区別されることがあり、/User-Guide/ と /user-guide/ が別のページとして扱われる場合があります。すべて小文字に揃えておくと安心です。日本語をURLに入れると %E3%81%82 のような文字列に変換されます。中身を確認したいときは、URLエンコード・デコードツールで元の文字に戻せます。

略語と数字を含む名前の注意点

HTTPServerかHttpServerか

「HTTP」や「ID」のような略語をキャメルケースやパスカルケースにするときは、考え方が2つに分かれます。

方針 例 採用している例
略語はすべて大文字のまま HTTPServer、userID PEP 8(HttpServerError より HTTPServerError がよいと明記)、Pythonの http.server.HTTPServer
略語も普通の単語として扱う HttpServer、userId Googleが公開しているJavaのスタイルガイド(例:XmlHttpRequest)、.NETの HttpClient

なお.NETのガイドラインには、2文字の略語だけは IO のように大文字のままにするという例外があります。JavaScriptの XMLHttpRequest は、XMLは大文字、Httpは単語扱いと、2つの方針が混ざった名前です。

すべて大文字にする方式の弱点は、略語が続くと区切りが見えなくなることです。XMLHTTPRequest では、どこで単語が切れているのか判断できません。他の書き方に変換する場合にも差が出ます。

  1. HttpServer は大文字の直前で区切ればよいので、迷わず http_server になります。
  2. HTTPServer は、大文字を1文字ずつ区切ると h_t_t_p_server になります。「大文字が続く部分の最後の1文字は次の単語の先頭」と判断する方法なら http_server になります。

どちらになるかは変換方法によって変わります。なお、ローワーキャメルケースの先頭に略語が来る場合は、hTTPServer ではなく httpServer と書くのが普通です。

数字を含む名前

多くのプログラミング言語では、名前を数字で始められません。2fa_code は使えないので、two_factor_code や code_2fa のように書き換えます。CSSのクラス名も、数字で始めるとセレクタで特別な書き方(エスケープ)が必要になります。

もう1つの問題は区切り位置です。address1 をスネークケースにすると address1 と address_1 のどちらにもなりえます。base64Encode も base64_encode と base_64_encode に分かれます。書き方を行き来させるうちに address_1 が address1 に変わってしまうこともあるため、「数字は直前の語にくっつける」のようにルールを決めておきます。

1つのプロジェクトで書き方が混ざる失敗と防ぎ方

よくある失敗

  • 同じ意味の userId と user_id がオブジェクトの中に両方あり、片方だけが更新されて値が食い違う
  • データベースから受け取った created_at を、JavaScript側で createdAt として読もうとして undefined になる
  • UserCard.js というファイルを userCard.js として読み込む。WindowsやmacOSは初期設定で大文字・小文字を区別しないので手元では動くが、区別するLinuxのサーバーに置くと失敗する
  • 日本語入力のまま打ってしまい、全角の「_」が混ざる。JavaScriptやJSONのキー、DBのカラム名では、user_id が user_id とは別の名前として扱われる(Pythonは変数名を正規化するため同じ名前になりますが、辞書のキーなど文字列としては別物です)

防ぎ方

書き方のルールは、READMEなどに文章で残しておきます。データベース(スネークケース)とJavaScript(キャメルケース)のように境目がある場合は、変換する場所をデータの受け渡し部分の1か所に決めます。あちこちで変換すると、どちらの書き方の値なのかわからなくなるためです。

チェックは自動化もできます。たとえばJavaScriptのESLintには camelcase ルールがあり、Pythonではflake8にpep8-namingというプラグインを追加すると命名をチェックできます。既存のコードに手を入れるときは、そのコードで多数派の書き方に合わせます。

大文字・小文字変換ツールで命名をまとめて変換する方法

項目名がたくさんあるときは、手で打ち直すより変換ツールを使うほうが確実です。大文字・小文字変換ツールは、英字の大文字・小文字の変換に加えて、キャメルケースとスネークケースへの変換に対応しています。

  1. 名前を英単語のスペース区切りで書き出します(例:user id、created at、max retry count)。全角の英字や記号が混ざっていると正しく区切られないことがあるので、ここで半角に揃えておきます。
  2. ツールの入力欄に貼り付けます。
  3. キャメルケースかスネークケースを選んで変換します。
  4. 略語や数字の区切り、全角文字が混ざっていないかを目で確認します。複数行を貼り付けた場合は、行ごとに正しく変換されているかも確かめてください。
  5. 他の書き方が必要なら、変換結果をもとに加工します。

5番の加工は、次のように組み合わせると簡単です。

  • ケバブケース:スネークケースに変換したあと、テキストエディタの置換で _ を - に置き換える
  • 大文字スネークケース:スネークケースに変換したあと、大文字に変換する
  • パスカルケース:キャメルケースに変換したあと、先頭の1文字だけを大文字にする

ツールの変換結果と、前の手順で加工した結果の例は次のとおりです。

元の単語 キャメルケース スネークケース 大文字スネークケース ケバブケース
user id userId user_id USER_ID user-id
created at createdAt created_at CREATED_AT created-at
max retry count maxRetryCount max_retry_count MAX_RETRY_COUNT max-retry-count

ツールで直接得られるのはキャメルケースとスネークケースの列です。大文字スネークケースとケバブケースの列は、スネークケースの結果に上の加工をしたものです。全角と半角の見分け方は「文字数の数え方|スペース・改行・全角半角・絵文字の扱いを解説」で詳しく説明しています。

用途別の早見表と名前を付ける前のチェックリスト

場所 基本の書き方 例
Pythonの変数・関数 スネークケース user_id
Pythonのクラス パスカルケース UserAccount
JavaScriptの変数・関数 キャメルケース userId
JavaScriptのクラス・Reactコンポーネント パスカルケース UserCard
定数(多くの言語で共通) 大文字スネークケース MAX_RETRY_COUNT
CSSのクラス名 ケバブケース user-card
データベースのカラム名 小文字のスネークケース user_id
URLのパス 小文字のケバブケース /user-id-guide/

名前を付ける前に、次の点を確認してください。

  • 使う言語やフレームワークの公式スタイルガイドを確認したか
  • 既存のコードやテーブルで多数派の書き方に合わせたか
  • 略語を大文字のままにするか、単語として扱うかを決めたか
  • 数字の区切り(address1 か address_1 か)を決めたか
  • 名前が数字で始まっていないか
  • 全角の記号や英字が混ざっていないか
  • ファイル名やURLが、大文字・小文字の違いだけで重複していないか
  • スネークケースとキャメルケースを変換する場所を1か所に決めたか

よくある質問

キャメルケースとスネークケースはどちらが読みやすいですか?

どちらが読みやすいかは、普段どちらを見慣れているかに大きく左右されるため、一概には言えません。実際には、読みやすさよりも、使う言語の慣習に合っていてプロジェクト内で統一されていることのほうが重要です。迷ったら、その言語の公式スタイルガイドに従うのが確実です。

ファイル名にはどの書き方を使えばよいですか?

スペースや日本語を避け、半角英数字の小文字にハイフンかアンダースコアを組み合わせるのが無難です。Pythonのモジュールはスネークケース、Reactのコンポーネントのファイルはパスカルケースのように、言語やフレームワークの慣習があればそちらを優先します。大文字・小文字の違いだけで別ファイルを作ると、OSによっては衝突するので避けてください。

変数名をローマ字(kokyaku_idなど)で付けてもよいですか?

文法上は問題なく使えますが、英語とローマ字が混ざると読み方や検索がしにくくなります。チームでローマ字を使うと決めているなら、その規則に統一してください。なお、Pythonなど一部の言語は日本語の変数名も使えますが、ツールや環境によっては扱いにくくなることがあります。

HTTPヘッダーのContent-Typeのような書き方は何と呼びますか?

単語の先頭を大文字にしてハイフンでつなぐ書き方は、トレインケース(Train-Case)と呼ばれることがあります。HTTPのヘッダー名は大文字・小文字を区別しない決まりなので、content-typeと書いても同じ意味になります。

ExcelやCSVの列名を英語にするときは、どの書き方がよいですか?

あとでデータベースに取り込んだりプログラムで読み込んだりする予定があるなら、小文字のスネークケース(user_idなど)にしておくと、そのまま列名として使えて扱いやすくなります。スペースや全角文字が入っていると、取り込み時にエラーになったり、引用符で囲む必要が出たりすることがあります。取り込み先のシステムに決まりがあれば、そちらに合わせてください。