【Python】命名規則の基本と実務で役立つ命名方法を初心者向けに解説

プログラミング言語•2025/2/17

Python

はじめに

プログラミングにおいて、命名規則は非常に重要です。Pythonでも、コードの可読性を高めるために適切な命名が求められます。適切な命名ができていれば、コードを読んだり修正したりする際に迷うことなく、作業がスムーズに進みます。

本記事では、Pythonの命名規則について、初心者でも理解できるようにわかりやすく解説します。実際のコード例を交えて、どのように命名規則を実践するかを見ていきましょう。

この記事を読むとわかること

Pythonの基本的な命名規則
変数名、関数名、クラス名などの適切な命名方法
実務で役立つ命名のヒント
Pythonの命名規則に従ったコードの書き方

Pythonの命名規則とは？

Pythonでは、PEP 8という公式のスタイルガイドが定められており、コードの可読性を保つための命名規則や書き方が示されています。このガイドラインに従うことで、チーム開発や他のプログラマーとの共同作業がよりスムーズに進みます。

PEP 8では、変数名、関数名、クラス名などに対する命名規則が定められています。まずは、基本的な命名規則を見ていきましょう。

変数名の命名規則

Pythonでは、変数名は小文字で始め、複数の単語をつなげる場合はアンダースコア（_）で区切ることが推奨されています。これをスネークケースと呼びます。


# 良い例
user_name = "Tom"
user_age = 25

# 悪い例
UserName = "Tom"  # クラス名に見える
userName = "Tom"  # 一貫性がない

ここでは、user_nameやuser_ageのように、単語ごとにアンダースコアで区切り、小文字で表記しています。

関数名の命名規則

関数名も変数名と同様に、小文字で始め、単語ごとにアンダースコアを使います。これもスネークケースを使用します。


# 良い例
def calculate_total_price(price, quantity):
    return price * quantity

# 悪い例
def CalculateTotalPrice(price, quantity):  # キャメルケースは使わない

関数名は動詞を使って、その関数が何をするかが分かりやすい名前を付けることが重要です。

クラス名の命名規則

クラス名は、キャメルケース（各単語の先頭を大文字にする）を使用します。最初の単語も大文字にするのが一般的です。


# 良い例
class UserProfile:
    pass

# 悪い例
class userprofile:  # 小文字で始めると、変数名と混同されやすい

クラス名は、名詞を使ってそのクラスが表すものを明確に示す名前を付けます。

定数の命名規則

定数には、すべて大文字のアルファベットを使用し、単語ごとにアンダースコアで区切ります。


# 良い例
MAX_USERS = 100

# 悪い例
MaxUsers = 100  # 定数に大文字を使わない

定数は変更されることがないため、その名前を見ただけで一目でわかるように、大文字で命名します。

実務で役立つ命名のヒント

命名規則を守ることは、チーム開発やメンテナンスが長期間にわたる場合に特に重要です。以下のヒントを覚えておきましょう。

明確な意味を持つ名前をつける

名前はその変数や関数が何をするものなのか、どんなデータを扱うものなのかを反映させるようにしましょう。例えば、get_user_age()という関数名は、その関数がユーザーの年齢を取得することを示しています。

一貫性を保つ

同じプロジェクト内では、命名規則を統一しましょう。例えば、変数名や関数名で一貫してスネークケースを使うようにします。

適切な長さの名前

名前は長すぎても短すぎてもいけません。短すぎると意味がわかりにくく、長すぎると読みにくくなります。例えば、numよりもuser_countの方がわかりやすいです。

よく使う命名規則をコード例で確認

ここで、実際のPythonコードでよく使う命名規則を見ていきましょう。


# 変数名
user_name = "Tom"
user_age = 25

# 関数名
def greet_user(name):
    print(f"Hello, {name}!")

# クラス名
class UserProfile:
    def __init__(self, name, age):
        self.name = name
        self.age = age

# 定数
MAX_USERS = 100

このコードでは、変数、関数、クラス、定数に対して適切な命名規則を守っていることがわかります。

まとめ

Pythonの命名規則を守ることは、コードの可読性を高め、チーム開発やメンテナンスを円滑に進めるために欠かせません。

本記事では、Pythonの基本的な命名規則や実務で役立つ命名のヒントを具体的なコード例とともに解説しました。ぜひ、この命名規則を実際のコードに活用して、読みやすくわかりやすいコードを書いていきましょう。