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

先生と生徒の会話形式で理解しよう

生徒

「Kotlinで変数を作るときの名前の付け方って、どうやって決めたらいいんですか？」

先生

「とても大事な質問ですね！Kotlinの変数名の付け方には、エラーが起きにくくするためのルールやポイントがあります。具体的に見ていきましょう。」

生徒

「なるほど。実際にどんなルールがあるのか知りたいです！」

先生

「では、基本的な命名規則や注意点を解説していきますね。」

1. 変数名とは？

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

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

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


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

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

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. わかりやすい名前をつけるポイント

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

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

Kotlinを基礎からしっかり学びたい人や、 Java経験を活かしてモダンな言語にステップアップしたい人には、定番の入門書がこちらです。

基礎からわかるKotlinをAmazonで見る

※ Amazon広告リンク

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

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

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

appleCount
userName
totalPrice

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

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

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


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

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

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

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

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

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

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

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

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

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

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

先生と生徒の振り返り会話

生徒

「変数名って、ただ適当に決めればいいのかと思ってましたが、ちゃんと意味を考えて付けるのが大事なんですね。」

先生

「そうですね。意味のある名前にすることで、コード全体が理解しやすくなり、後から自分で見返すときにも迷いにくくなりますよ。」

生徒

「キャメルケースっていう書き方も、最初はちょっと難しそうだけど、慣れれば自然にできそうです。」

先生

「ええ、最初は意識して練習していくと自然と身につきます。実務でもキャメルケースはよく使われているので、今のうちに覚えておきましょう。」

生徒

「これからは、何のための変数かすぐわかるように名前を考えてみます！」