カテゴリ: C# 更新日: 2025/12/06

C#の変数名の付け方とは?初心者でもわかる命名規則と注意点

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

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

生徒

「C#で変数ってよく出てくるけど、名前の付け方って決まりがあるんですか?」

先生

「はい、実は変数名にはわかりやすくするためのルールや命名規則があるんです。特に初心者は、それを守ることでエラーを防いだり、他の人にも読みやすくなりますよ。」

生徒

「なるほど、どんなふうに名前を付ければいいのか教えてください!」

先生

「では、C#での変数名の付け方を基本から詳しく解説していきましょう!」

1. 変数とは?

1. 変数とは?
1. 変数とは?

変数(へんすう)とは、プログラムの中で「値(あたい)」を入れておく“入れ物”のようなものです。たとえば、名前や年齢などの情報を一時的に保管しておくために使います。

現実の例で言えば、「ラベルを貼った箱」と考えてみましょう。箱には「りんご」や「みかん」などの中身が入っていて、ラベルには「fruits」や「fruitName」などの名前が書かれています。これが変数と変数名のイメージです。

2. C#での変数名の基本ルール

2. C#での変数名の基本ルール
2. C#での変数名の基本ルール

C#で変数名をつけるときには、以下の基本ルールを守りましょう。これらを守らないとエラーが出ることがあります。

  • 英数字(A~Z、a~z、0~9)とアンダースコア(_)のみ使える
  • 数字から始めてはいけない
  • 記号(@, #, $, %, など)は使えない
  • スペースは使えない
  • 予約語(int, class, publicなど)は使えない

例えば、次のような変数名はエラーになります:


int 1name;        // 数字から始まっているのでエラー
int my name;      // スペースがあるのでエラー
int public;       // C#の予約語なのでエラー

3. 読みやすくエラーの起きにくい命名規則(キャメルケース)

3. 読みやすくエラーの起きにくい命名規則(キャメルケース)
3. 読みやすくエラーの起きにくい命名規則(キャメルケース)

プログラミングでは、ただエラーが出ないだけでなく「わかりやすく」書くこともとても大切です。そのために、キャメルケース(camelCase)という書き方を使います。

キャメルケースとは、単語の最初の文字を小文字にし、2つ目以降の単語の頭文字を大文字にする方法です。

たとえば:

  • userName(ユーザー名)
  • totalPrice(合計金額)
  • isLogin(ログインしているかどうか)

これらは一目で意味がわかる変数名で、他の人が見ても読みやすいです。

4. わかりやすい名前をつけるコツ

4. わかりやすい名前をつけるコツ
4. わかりやすい名前をつけるコツ

変数名をつけるときは、できるだけ意味がわかる名前を使いましょう。
以下にわかりやすさの違いを比較してみましょう。


// わかりにくい変数名
int a = 10;
int b = 20;

// わかりやすい変数名
int appleCount = 10;
int orangeCount = 20;

appleCount や orangeCount のように、「何を表しているか」がはっきりしていると読みやすくなります。

5. よく使われるプレフィックス(接頭辞)

5. よく使われるプレフィックス(接頭辞)
5. よく使われるプレフィックス(接頭辞)

変数名の先頭に、どんな種類のデータかを表す「プレフィックス(prefix)」をつけると、さらにわかりやすくなります。ただし、C#ではこの書き方は必須ではありませんが、初心者には便利です。

  • str: 文字列(string型) 例:strName
  • int: 数字(int型) 例:intAge
  • bool: 真偽(boolean型) 例:boolIsLogin

ただし、C#の公式なスタイルでは「型名を入れないシンプルな名前」が推奨されています。どちらを使うかはプロジェクトやチームの方針に合わせましょう。

6. 変数名に使ってはいけない例

6. 変数名に使ってはいけない例
6. 変数名に使ってはいけない例

次のような変数名は避けましょう。初心者がよくやりがちなミスです。

  • 意味のない名前: x, y, tmp など
  • 長すぎる名前: userNameOfCustomerInShoppingMall2024
  • 日本語の変数名: 一応使えますが、英語で書くのが一般的です

バランスよく、簡潔で意味が伝わる英語を使うのがベストです。

7. 実際に変数を使ってみよう

7. 実際に変数を使ってみよう
7. 実際に変数を使ってみよう

では、C#で変数を実際に宣言し、値を代入して表示してみましょう。


string userName = "たろう";
int userAge = 20;

Console.WriteLine("名前は " + userName + " です。");
Console.WriteLine("年齢は " + userAge + " 歳です。");

実行結果:


名前は たろう です。
年齢は 20 歳です。

8. よくある質問と注意点

8. よくある質問と注意点
8. よくある質問と注意点

Q1: 大文字と小文字は区別されますか?
→ はい、C#では大文字と小文字が区別されます。userNameUserNameは別の変数として扱われます。

Q2: アンダースコア(_)は使っていいですか?
→ 使えますが、C#の一般的なスタイルではキャメルケースが推奨されています。

Q3: 変数名に日本語は使えますか?
→ 技術的には可能ですが、実務では英語が一般的です。

まとめ

まとめ
まとめ

C#の変数名の付け方について学ぶことで、コードの可読性が格段に向上し、エラーの予防にもつながることが理解できました。
初心者が陥りやすいミスを避けるためにも、「キャメルケース」や「意味のある英単語を用いること」が重要です。特に、数字で始まる変数名予約語を使った名前などは、コンパイルエラーを引き起こしやすいため、注意が必要です。
また、アンダースコアの使い方や、日本語を変数名に使うことの是非も理解しておくと、実務でのトラブルも減ります。
実際のコード例で確認したように、単に動作するコードを書くのではなく、読みやすさ・チームでの協調・将来の保守性を意識することで、より良いC#プログラマーへの第一歩となります。

変数名の付け方で差が出るコードの例

以下に、よくある間違った書き方と、適切な命名をした場合の比較を示します。


// NG例:意味のわからない変数名
int x = 100;
int y = 200;
int z = x + y;
Console.WriteLine(z);

// OK例:明確な意味をもつ変数名
int applePrice = 100;
int orangePrice = 200;
int totalPrice = applePrice + orangePrice;
Console.WriteLine(totalPrice);

このように、applePricetotalPriceのように具体的な名前にすることで、コードを読むだけで「何をしているのか」が理解しやすくなります。

プレフィックスの使い方に注意

初心者のうちは、strNameintAgeのようなプレフィックスを使うと、型の見分けがつきやすくなり便利です。ただし、C#の公式なガイドラインでは、こうしたプレフィックスは不要とされており、型ではなく「役割」に着目した名前付けが好まれます。

プロジェクト全体で統一することが大切

命名規則は、プロジェクトやチーム全体で統一することが大切です。一人だけ独自ルールで変数名をつけると、保守がしづらくなり、バグの原因になることもあります。チームのスタイルガイドに従いながら、柔軟に運用する姿勢が重要です。

初心者にありがちな間違いのチェックリスト

  • 変数名が英単語ではなく、ローマ字や日本語になっている
  • 短すぎて意味の伝わらない名前になっている
  • 使われていない変数を残している
  • ローカル変数に冗長なプレフィックスをつけている(例:intUserAge)

これらを見直すだけでも、コードの品質はぐっと向上します。

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

生徒

「先生、C#の変数名って本当に奥が深いんですね!ただ名前をつけるだけかと思ってました。」

先生

「そうなんです。変数名はコードの“顔”みたいなもので、いい名前をつけると、それだけでコードの意味が伝わりやすくなります。」

生徒

「キャメルケースとかプレフィックスとか、ルールがあると迷わなくて助かります!」

先生

「最初は型のプレフィックスを使ってもいいけど、慣れてきたらシンプルで意味のある名前を考えられるようになるといいですね。」

生徒

「これからは、xとかyとかじゃなくて、ちゃんと意味のある名前をつけます!」

先生

「その意識があれば、他の人からも読みやすいコードだと褒められますよ。いい習慣を続けましょう!」

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

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

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

C#で変数名の付け方にルールはありますか?初心者にもわかりやすく教えてください。

はい、C#の変数名には基本的なルールがあります。英数字とアンダースコアのみが使用でき、数字から始めてはいけません。予約語やスペース、記号も使えません。
カテゴリの一覧へ
新着記事
New1
C#
C#のデリゲートとは?メソッドを変数のように扱う基本を解説
New2
C#
C#の文字列型(string)を完全解説!連結・分割・検索の方法を紹介
New3
C#
C#非同期処理の進捗状況を表示!IProgressの使い方を初心者向けに解説
New4
C#
C#の文字列フォーマット方法!String.Format・補間文字列の使い方
人気記事
No.1
Java&Spring記事人気No1
C#
C#でJSONファイルを読み書きする方法(JsonSerializer・Newtonsoft.Json)
No.2
Java&Spring記事人気No2
C#
C#のrefとoutキーワードとは?引数の参照渡しを理解しよう
No.3
Java&Spring記事人気No3
COBOL
COBOLの数値データ型「PIC 9」の使い方と注意点をやさしく解説!
No.4
Java&Spring記事人気No4
C#
C#の引数と戻り値の基本!値を受け渡し・返す仕組みを理解しよう
No.5
Java&Spring記事人気No5
C#
C#の非同期処理とUIスレッドをマスター!WPF/WinFormsでアプリが止まる問題を解決
No.6
Java&Spring記事人気No6
C#
C#で型を調べる方法!GetType()・typeof演算子の違いと使い方
No.7
Java&Spring記事人気No7
COBOL
COBOLのMOVE文を完全ガイド!初心者でもわかるデータ移送の基本
No.8
Java&Spring記事人気No8
C#
C#でファイルのエンコーディングを指定する方法(UTF-8・Shift-JISなど)