Python｜変数名の付け方と命名規則

1. はじめに

Pythonの学習を始めたばかりの方が最初につまずくポイントのひとつが「変数名の付け方」です。
本記事では、Pythonにおける変数名の命名規則や、可読性の高い変数名を付けるためのコツを、実際のコード例とともに丁寧に解説します。

変数名は、コードの意味や意図を読み取るうえで非常に重要です。良い変数名をつけることで、自分自身だけでなく、他人がコードを読むときの理解度も大きく変わります。
この記事では、初心者〜中級者向けに、Pythonにおける命名のルールと実務的な工夫について紹介します。

Pythonの変数名には、以下のような基本ルールがあります：

# 正しい変数名
user_name = "Alice"
age = 25
is_active = True

# 間違った変数名（数字から始まる）
# 2user = "Bob"  ← エラーになります

Pythonでは、複数の単語をつなげるときにスネークケース（単語の区切りをアンダースコアで繋ぐ）を使用するのが一般的です。

# スネークケースの例
total_price = 1000
user_email_address = "test@example.com"

以下のようなキーワードはPythonの構文として予約されているため、変数名として使うことはできません。

if, else, for, while, class, def, return, import, from, try, except, True, False, None

コードの意味を明確にするため、目的を表す名前を付けましょう。

# 悪い例
a = 100
b = 0.1
c = a * b

# 良い例
price = 100
tax_rate = 0.1
total = price * tax_rate

True や False を取る変数には、状態を示す接頭語（is、has、can など）を使うと、読みやすくなります。

is_logged_in = True
has_permission = False
can_edit = True

data や info などのあいまいな名前は、意味を正確に伝えません。具体的な内容を反映した名前をつけるのがポイントです。

Pythonでは変数名に大文字と小文字の違いがあるため、name と Name は別物です。思わぬバグの原因になるため注意しましょう。

同じ名前で変数を上書きしてしまうと、元の値が失われます。特にループ内や関数内では慎重に扱いましょう。

この記事では、Pythonにおける変数名の付け方と命名規則について、基本から実務的な応用まで詳しく解説しました。

命名規則をしっかり守ることは、バグを防ぎ、他の人にも読みやすいコードを書く第一歩です。
実務でも、「あとから読み返してもわかる変数名」を意識することで、保守性の高いコードが書けるようになります。

ぜひ今後のコーディングに活かしてみてください！