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

初心者のうちは、変数名をつけるときに「何が入るのか・どのくらいなのか・いつの値なのか」が一目で伝わるように意識すると、読みやすさが一気に上がります。短すぎて意味が伝わらないより、やや長くても具体的な名前のほうが後から迷いません。

命名の具体テクニック

名詞＋用途で意味を明確に（例：appleCount、userName、totalPrice）。
単位を後ろに付けると実務で強い（例：priceYen、delayMs、weightKg）。
ブール値はis/has/canで始める（例：isActive、hasCoupon、canRetry）。
配列やリストは複数形（例：items、userIds）。数はCount、合計はTotal。
期間や範囲はstart/endやmin/maxを対で使う（例：saleStart/saleEnd）。
略語は避け、必要なら一般的な略語だけに（id、url、apiなど）。
否定形より肯定形（isEnabledを使い、isNotDisabledのような二重否定は避ける）。

次の短いサンプルで、良い名前と避けたい名前の違いを体感してみましょう。どれもKotlinの基本構文だけで動き、キャメルケースで統一しています。


// ✅ 意味が伝わる命名
val appleCount = 8
val priceYen = 1200
val isMember = true
val saleStart = "2025-11-01"
val saleEnd = "2025-11-15"
println("個数=$appleCount, 価格=${priceYen}円, 会員=$isMember, 期間=$saleStart〜$saleEnd")

// ❌ 何の数か不明／意図が読み取りづらい
/*
val a = 8
val p = 1200
val flag = true
val s1 = "2025-11-01"
val s2 = "2025-11-15"
*/

「名詞＋役割＋必要なら単位」を心がけるだけで、Kotlinのコード全体が読みやすくなります。とくにブール値のisや、数量のCount、金額のYenなどは実務でよく使う型番のようなもの。毎回迷わず書ける“定番”にしておくと、チームでの読み合わせやデバッグがぐっと楽になります。

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

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

生徒

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

先生

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

生徒

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

先生

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

生徒

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

先生

「とてもいい心がけですね。変数名はコードの中で一番よく見る部分なので、大事に考えていきましょう。」

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

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

※ Amazon広告リンク

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

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

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

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

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

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

Kotlinの変数名でスペース（空白）を使うとどうなりますか？

Kotlinでは変数名にスペースを使うことはできません。スペースを入れると構文エラーになります。単語の区切りにはキャメルケースを使いましょう。

【未経験OK】Kotlinで始めるプログラミング入門｜ゼロから「動く喜び」を体験する60分

「プログラミングを始めたい」を形にする。最新言語Kotlinで楽しむ、ものづくりの第一歩。

本講座は、プログラミング経験が全くない方のためのエントリー講座です。「コードを書くってどういうこと？」という基本から、世界中で使われている最新言語Kotlin（コトリン）を使って、実際にプログラムを動かすまでを体験します。難しい理屈よりも、まずは「自分の手で動かす楽しさ」を最短距離で実感していただきます。