Kotlinでの変数名の付け方とは？わかりやすくエラーの起きにくい命名規則を紹介

1. 変数名とは？

1. 変数名とは？

まず「変数名」というのは、Kotlinプログラムの中で値を保存するための「箱」につけるラベルのようなものです。箱に名前がないと、中身が何なのか分からなくなってしまいますよね。だからこそ、変数には分かりやすい名前をつけることが大切です。

例えば、りんごの数を数えるプログラムを書くとします。変数名をaとするより、appleCountとした方が「何が入っている変数なのか」が一目で分かります。

実際のKotlinコードでも、とてもシンプルに使えます。

fun main() {
    val appleCount = 5      // りんごの数を入れる箱（変数名）
    println("りんごの個数は $appleCount 個です")
}

このように、変数名はただの文字ではなく「意味を伝える名前」です。プログラミング初心者でも、後から見たときに「この変数は何だったかな？」と迷わないよう、中身が想像できる名前を付けるのが基本になります。

2. Kotlinの変数名の基本ルール

2. Kotlinの変数名の基本ルール

Kotlinで読みやすく、エラーの起きにくい変数名にするための土台をまとめます。まずは「機械に怒られない」最低限の約束を押さえておきましょう。ここができていれば、後の命名の工夫（意味づけやキャメルケース）もスムーズに活きます。

• 英字（アルファベット）から始める：数字や記号では始められません。最初は小文字で始めるのがKotlinの慣習です。
• 大文字と小文字は区別される：「apple」と「Apple」は別物です。変数は小文字始まり、クラス名は大文字始まりと覚えると整理しやすいです。
• 英字・数字・アンダースコア（_）を使える：ハイフン（-）やスラッシュ（/）などの記号は使えません。読みやすさ重視でcamelCase（例：totalPrice）にしましょう。
• スペースは使えない：「apple count」のような空白は不可です。単語をつなげるときはappleCountのように書きます。
• 予約語は名前にしない：class、fun、valなど言語のキーワードは変数名に使えません。

OK・NGの雰囲気をつかむために、短いサンプルを置いておきます（コンパイルを通すにはOK行だけを使って試してください）。

// ✅ OK：小文字ではじめ、camelCaseで意味が伝わる
val appleCount = 12
val totalPrice = 1200
val userName = "Taro"

// ❌ NG：数字から開始（エラー）
/*
val 1apple = 5
*/

// ❌ NG：スペースを含む（エラー）
/*
val apple count = 5
*/

// ❌ NG：記号（-）を含む（エラー）
/*
val apple-count = 5
*/

// ❌ NG：予約語は使えない（エラー）
/*
val class = "A"
*/

最初は「小文字ではじめる・単語をつなぐときは大文字で区切る・意味が分かる名前」の3点セットを意識すれば十分です。Kotlinの命名は読みやすさが最優先。後から見返した自分が迷わない名前にしておくと、バグの早期発見や修正もしやすくなります。

3. わかりやすい名前をつけるポイント

3. わかりやすい名前をつけるポイント

初心者のうちは、変数名をつけるときに「何を入れるのか」をはっきりさせるのが大切です。意味のある名前をつけると、自分でも他の人でも理解しやすくなります。

例えば、りんごの個数を表すときは、単に「a」や「x」とするよりも「appleCount」と書いたほうがわかりやすいですね。

4. キャメルケースを使う

4. キャメルケースを使う

Kotlinでは、変数名をつけるときにキャメルケース（camelCase）という書き方がよく使われます。キャメルケースは、最初の単語を小文字で書き、2つ目以降の単語の先頭を大文字にする方法です。

例えば、次のようになります。

• appleCount
• userName
• totalPrice

この書き方にすると、変数名が見やすくなり、後から見たときに内容をすぐに理解できます。

5. 具体的なKotlinのサンプルコード

5. 具体的なKotlinのサンプルコード

それでは、実際にKotlinで変数名を付ける例を見てみましょう。

fun main() {
    val appleCount = 10
    val userName = "Taro"
    val totalPrice = 1200

    println("りんごの個数: $appleCount")
    println("ユーザー名: $userName")
    println("合計金額: $totalPrice")
}

このように、変数名はすべて意味のある英単語を使って、キャメルケースで書くと読みやすいです。

6. NGな変数名の例と理由

6. NGな変数名の例と理由

逆に、こんな名前の変数は避けましょう。

• aやxyzなど意味がわからない名前：後で見ても内容が分かりません。
• 1appleのように数字から始まる：Kotlinのルールでエラーになります。
• apple countのようにスペースを入れる：これもエラーの原因です。
• apple-countのように記号を使う：ハイフンは変数名には使えません。

7. エラーを防ぐための命名のコツ

7. エラーを防ぐための命名のコツ

最後に、エラーを防ぐためのコツをまとめておきます。

• 必ず英字から始める。
• 単語の区切りは大文字にする（キャメルケース）。
• 内容がわかる名前をつける。
• 長すぎない名前にする：あまりに長いと読みにくいです。
• プログラム内で同じ名前を使い回さない：同じ名前を使うと混乱しやすくなります。

これらを意識すれば、Kotlinのプログラムを書くときに「どんな変数だったっけ？」と迷わずに済みますし、エラーも防ぎやすくなりますよ。

8. 変数名の例え話でイメージしよう

8. 変数名の例え話でイメージしよう

たとえば、家の中で「冷蔵庫の中に入っているりんごの数」と「机の上にあるノートの数」を数えるとき、箱に「りんご箱」「ノート箱」とラベルをつけるようなものです。Kotlinでは、その「ラベル（箱の名前）」が変数名です。何が入っているのかがすぐ分かるように、分かりやすい名前をつけるのがポイントです。

まとめ

まとめ

Kotlinでの変数名の付け方は、ただの名前ではなく、プログラム全体の読みやすさや保守性、エラーの少なさにも大きく関わる重要な要素です。特に初心者のうちは、意味のある単語を使い、キャメルケースで命名することで、後から見ても自分や他人が理解しやすいコードになります。今回の記事では、基本的な命名ルールや避けるべき例、実際のサンプルコードまでを紹介しながら、わかりやすく変数名の考え方を学びました。

Kotlinでは、変数名は英字から始めることが基本であり、数字や記号を先頭に使うとエラーになります。また、変数名にスペースやハイフンなどの記号を使うことも禁止されています。さらに、意味のない文字列や省略語は避け、できるだけ内容がすぐにわかる単語を選ぶことで、バグを防いだり、他の開発者と協力しやすくなったりします。

実際に変数名を付けるときには、例えば「合計金額」にはtotalPrice、「ユーザー名」にはuserNameなど、何を表しているのかが明確になるように命名するとよいでしょう。また、キャメルケース（camelCase）を意識することで、複数の単語が読みやすく区切られるため、見た目も整理されて読みやすくなります。

以下のようなコードのように、変数名の付け方ひとつで、コードの印象が大きく変わります。

fun main() {
    val itemCount = 5
    val customerName = "Hanako"
    val discountRate = 0.15

    println("商品数: $itemCount")
    println("顧客名: $customerName")
    println("割引率: $discountRate")
}

このようにKotlinでは、変数名＝プログラムの説明文という意識で書くと、エラーが起きにくく、保守性の高いコードになります。わかりやすさは初心者だけでなく、経験者にとっても大切な要素です。変数名の工夫ができるようになると、よりよいコードを書けるようになります。

この記事を読んだ人からの質問

この記事を読んだ人からの質問

プログラミング初心者からのよくある疑問／質問を解決します

Kotlinで変数名を決めるときに、日本語は使えますか？

Kotlinでは変数名に日本語を使うことはできますが、英語を使った命名のほうが一般的です。読みやすさや保守性、他のプログラマーとの共有を考えると、英語の単語を使ってキャメルケースで書くのがおすすめです。

Kotlinの変数名で数字から始めるとエラーになるのはなぜですか？

Kotlinの文法ルールでは、変数名は英字（アルファベット）で始める必要があります。数字から始めると構文エラーになるため、先頭には必ず英字を使いましょう。