【Python】class変数の基本とインスタンス変数との違いを解説

公開：2025年3月5日更新：2025年3月5日

Pythonのclass変数の基本と定義方法
class変数とインスタンス変数の違いと使い分け
class変数の応用例と注意点

Pythonのclass変数の基本と定義方法

Pythonのclass変数はclass内で定義され、そのclassすべてのインスタンスで共有される変数です。class変数はclass定義の直下に記述することによって作成され、class名を通じて直接アクセスすることができます。

class変数は「インスタンス間で共通のデータを保持する場合」や「classに関連する定数を定義する場合」などに有用です。また、class変数を使用することによってコードの重複を減らし、メモリ使用量を最適化することもできます。

【サンプルコード】
class MyClass:
    class_variable = "I am a class variable"  # class変数の定義

# class変数へのアクセス
print(MyClass.class_variable)

# インスタンスを作成
obj1 = MyClass()
obj2 = MyClass()

# インスタンスを通じてclass変数にアクセス
print(obj1.class_variable)
print(obj2.class_variable)

# class変数の値を変更
MyClass.class_variable = "I have been modified"

# 変更後の値を確認
print(obj1.class_variable)
print(obj2.class_variable)

【実行結果】
I am a class variable
I am a class variable
I am a class variable
I have been modified
I have been modified

上記のサンプルコードではMyClass内にclass_variableというclass変数を定義しています。class名を通じて直接アクセスできるだけではなく、インスタンスを通じてもアクセスできることがわかります。class変数の値を変更すると、すべてのインスタンスで変更が反映されることがPythonのclass変数の重要な特性です。

「Python」を学べるコードキャンプのサービス

class変数とインスタンス変数の違いと使い分け

class変数とインスタンス変数は、Pythonのオブジェクト指向プログラミングにおいて重要な概念です。class変数はclass全体で共有されるのに対し、インスタンス変数は各インスタンスに固有のデータを保持します。この違いを理解することによって、適切な変数の使い分けが可能になります。

class変数は全インスタンスで共有される一方、インスタンス変数は__init__メソッド内でselfキーワードを使用して定義されます。インスタンス変数は各オブジェクトに固有の値を持つため、一つのインスタンスの変数を変更しても他のインスタンスには影響を与えません。

【サンプルコード】
class Car:
    total_cars = 0  # class変数
    
    def __init__(self, brand):
        self.brand = brand  # インスタンス変数
        Car.total_cars += 1  # class変数の更新
        
# インスタンスを作成
car1 = Car("Toyota")
car2 = Car("Honda")

print(f"Total cars: {Car.total_cars}")
print(f"Car 1 brand: {car1.brand}")
print(f"Car 2 brand: {car2.brand}")

# インスタンス変数を変更
car1.brand = "Lexus"
print(f"Car 1 brand after change: {car1.brand}")
print(f"Car 2 brand: {car2.brand}")

【実行結果】
Total cars: 2
Car 1 brand: Toyota
Car 2 brand: Honda
Car 1 brand after change: Lexus
Car 2 brand: Honda

上記のサンプルコードでは、total_carsというclass変数とbrandというインスタンス変数を定義しています。class変数total_carsは全てのインスタンスで共有され、車の総数を追跡します。一方、インスタンス変数brandは各車の固有のブランドを保持します。インスタンス変数を変更しても他のインスタンスには影響しません。

class変数は統計情報やカウンタなど共有データに適しているのに対し、インスタンス変数は個々のオブジェクト固有の属性を表現するのに最適です。

class変数の応用例と注意点

class変数は設定値の共有やインスタンスのカウント、デフォルト値の設定など様々な場面で活用できます。しかし、ミュータブル（変更可能）なオブジェクトをclass変数として使用する場合は注意が必要であり、予期せぬ動作を引き起こす可能性があります。

class変数を使用する際は、その変数が全てのインスタンスで共有されることを常に意識する必要があります。特にリストや辞書などのミュータブルなオブジェクトをclass変数として使用する場合は、意図しない副作用を避けるために慎重に設計するようにしましょう。

【サンプルコード】
class Student:
    all_students = []  # ミュータブルなclass変数
    
    def __init__(self, name):
        self.name = name
        Student.all_students.append(self.name)
        
# インスタンスを作成
student1 = Student("Alice")
student2 = Student("Bob")
print("All students:", Student.all_students)

# 新しいインスタンスを作成
student3 = Student("Charlie")
print("Updated all students:", Student.all_students)

# class変数を直接変更
Student.all_students.append("David")
print("Final all students:", Student.all_students)

【実行結果】
All students: ['Alice', 'Bob']
Updated all students: ['Alice', 'Bob', 'Charlie']
Final all students: ['Alice', 'Bob', 'Charlie', 'David']

上記のサンプルコードでは、all_studentsというミュータブルなclass変数を使用しており、新しいStudentインスタンスが作成されるたびに、そのインスタンスの名前がリストに追加されます。このアプローチは全ての学生を追跡するのに便利ですが、class変数が直接変更可能であることに注意が必要です。ミュータブルなclass変数を使う場合は意図しない変更を防ぐため、メソッドを通じてのみアクセスできるよう設計した方が良いでしょう。

class変数の力を最大限に活用するには、イミュータブル（不変）なデータ型を使用するか、適切なカプセル化を行うことが重要です。特に大規模なプロジェクトでは、class変数のスコープと影響範囲を明確に理解した上で利用することがバグを防ぐ鍵となります。

※上記コンテンツの内容やソースコードはAIで確認・デバッグしておりますが、間違いやエラー、脆弱性などがある場合は、コメントよりご報告いただけますと幸いです。