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

1. Pythonの変数名の基本ルール

1. Pythonの変数名の基本ルール

Pythonで変数名を付けるときには、いくつかの基本ルールがあります。ここでは、その基本ルールをやさしく説明します。

• 変数名は半角英数字（a～z、A～Z、0～9）とアンダースコア（_）だけが使えます。
• 変数名は数字では始められません。1st_nameのような名前はエラーになります。
• 変数名は大文字と小文字を区別します。たとえば、Ageとageは別の変数として扱われます。
• 変数名に空白（スペース）は使えません。空白を使いたい場合は、アンダースコアでつなげます（例：user_name）。

2. Pythonでのエラーにならない変数名の例

2. Pythonでのエラーにならない変数名の例

実際にPythonで正しく動く変数名の例を見てみましょう。

name = "たろう"
age = 20
user_name = "hanako"

これらの変数名は、すべてPythonのルールを守っているので問題なく使えます。

3. エラーになる変数名の例を知ろう

3. エラーになる変数名の例を知ろう

逆に、ルールを守らない変数名はPythonではエラーになります。たとえば、こんな例です。

1st_name = "たろう"  # 数字で始まるのでエラー
user name = "はなこ"  # 空白が入っているのでエラー

これらの変数名は、Pythonのルールに合わないため、プログラムを実行するとエラーになります。SyntaxError（文法エラー）というエラーが表示されることが多いです。

4. わかりやすい変数名を付けよう

4. わかりやすい変数名を付けよう

Pythonでは、ルールを守るだけでなく、わかりやすい変数名を付けることも大切です。変数名は、自分や他の人が見てすぐに何のデータか分かるようにしましょう。

たとえば、年齢を保存する変数はageやuser_age、名前を保存する変数はnameやuser_nameなどにすると分かりやすいです。

5. エラーの起きにくい命名規則を覚えよう

5. エラーの起きにくい命名規則を覚えよう

エラーにならないだけでなく、コードを読みやすくするために、Pythonではスネークケース（snake_case）という書き方をおすすめします。

スネークケースとは、単語と単語の間をアンダースコアでつなぐ書き方です。たとえば、user_ageやuser_nameのように書きます。これは、Pythonのプログラムでよく使われる書き方で、読みやすくエラーも起きにくいです。

逆に、userNameのような書き方（キャメルケース）もありますが、Pythonではスネークケースのほうが一般的です。

6. Pythonのキーワードには注意しよう

6. Pythonのキーワードには注意しよう

Pythonには、予約語（キーワード）と呼ばれる特別な言葉があります。たとえば、ifやfor、whileなどです。

これらの予約語は、Pythonがすでに使っている言葉なので、変数名として使うことはできません。もし変数名に予約語を使おうとすると、エラーが起きます。

Pythonの予約語はたくさんあるので、心配なときは「Python 予約語」と検索して確認すると良いでしょう。

7. 実際に変数名を付けてプログラムを書いてみよう

7. 実際に変数名を付けてプログラムを書いてみよう

最後に、正しい変数名の付け方を使った簡単なプログラムを見てみましょう。

user_name = "さくら"
user_age = 25
print("こんにちは、" + user_name + "さん！")
print("あなたの年齢は" + str(user_age) + "歳ですね。")

実行すると、こんな結果が表示されます。

こんにちは、さくらさん！
あなたの年齢は25歳ですね。

このプログラムは、スネークケースでわかりやすくエラーの起きにくい変数名を使っています。プログラムを作るときは、こうしたルールを守るだけでなく、自分でも読みやすい名前を意識して書いていきましょう。

まとめ

まとめ

Pythonでの変数名の付け方は、単にルールとして覚えるだけでなく、実際のプログラムを読みやすくし、エラーの少ないコードを書くための重要な基礎となります。変数名は数字で始めない、空白を入れない、アンダースコアで単語をつなぐ、そしてすでにPythonが意味を持っている予約語を使わないなど、押さえておくべきポイントがいくつもあります。特にスネークケースはPythonで広く使われている書き方であり、見た瞬間に意味が理解しやすく、プログラム全体の可読性を高める大切な習慣です。初心者のうちからこうした命名規則に慣れておくことで、後のコード修正や拡張が格段に楽になります。

また、変数名は「自分が理解できればよい」だけでなく、後から読み返す自分や、他の人が見てもすぐに意味がつかめることが大切です。たとえば「age」や「user_age」「user_name」「total_price」のように、役割が具体的に分かる変数名は、プログラムの意図を明確にし、複雑な処理の中でも迷いにくくしてくれます。逆に意味のない短い名前や、ややこしい省略を使うと、読み手が混乱しやすくなり、エラーの原因にもつながります。変数名はプログラムの一部であると同時に、読み手とのコミュニケーションでもあるため、丁寧に付ける意識がとても大切です。

さらに、予約語を変数名として使うとPython内部の文法と衝突してしまうため、思わぬエラーが起きます。初心者ほど気づきにくい部分ですが、「if」「for」「while」「class」などの言葉は、本来Pythonが文法として使うものなので変数にできません。これらを避けるためには、キーワード一覧を確認しておく習慣をつけると安心です。命名の基本を守りつつ、意味の通る名前とスネークケースを使えば、初心者でも品質の高いコードに近づくことができます。

サンプルプログラムで命名規則を確認しよう

以下は、正しい命名規則を用いたサンプルコードです。スネークケース、適切な命名、予約語の回避など、学んだ内容が自然に組み込まれています。

user_name = "ゆき"
user_age = 30
user_city = "東京"

def create_message(name, age, city):
    info_text = "こんにちは、" + name + "さん！"
    detail_text = "年齢は" + str(age) + "歳で、お住まいは" + city + "ですね。"
    return info_text + " " + detail_text

message = create_message(user_name, user_age, user_city)
print(message)

このプログラムでは、変数名の意味が明確で、どんな情報を扱っているかがすぐ理解できます。関数名もスネークケースで統一されており、読みやすさと整理しやすさが意識されています。変数名の付け方は、プログラムの質を左右する大切な技術なので、単語の選び方や書き方を意識しながら練習していけば、Pythonの理解がより深まり、複雑な処理でも迷わず書けるようになります。

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

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

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

Pythonで変数名をつけるときの基本的なルールは何ですか？

Pythonでは、変数名に使えるのは半角英数字とアンダースコア（_）のみです。また、変数名の最初を数字にすることはできません。大文字と小文字は区別され、空白（スペース）は使えません。