Pythonでクラス変数を変更する方法：インスタンス変数との違いと正しい書き方

Pythonのオブジェクト指向プログラミングでは、変数を「クラスレベル」または「インスタンスレベル」で定義できます。変数とは、プログラム内で扱う値を表す記号にすぎません。

クラスレベルで定義された変数はクラス変数、インスタンス（オブジェクト）レベルで定義された変数はインスタンス変数と呼ばれます。両者の違いは、以下のシンプルな例で確認してみましょう。

クラス変数とインスタンス変数の基本例

# Sharkクラスの定義
class Shark:
    animal_type = 'fish'  # クラス変数

    def __init__(self, name, age):
        self.name = name  # インスタンス変数
        self.age = age    # インスタンス変数

# Sharkクラスのオブジェクトを作成
obj1 = Shark("Jeeva", 54)
obj2 = Shark("Roli", 45)

print("2つのインスタンスからクラス変数を表示")
print("obj1.animal_type =", obj1.animal_type)
print("obj2.animal_type =", obj2.animal_type)

# インスタンス経由でクラス変数を変更しようとする
obj1.animal_type = "BigFish"

print("\n1つのインスタンスを変更した後のクラス変数")
print("obj1.animal_type =", obj1.animal_type)
print("obj2.animal_type =", obj2.animal_type)

このプログラムでは、Sharkクラスを作成し、オブジェクト経由でクラス変数を変更しようとしています。しかし、この書き方ではそのオブジェクト専用の新しいインスタンス変数が作成され、元のクラス変数が隠されてしまいます。これを「シャドーイング」と呼びます。

実行結果

2つのインスタンスからクラス変数を表示
obj1.animal_type = fish
obj2.animal_type = fish

1つのインスタンスを変更した後のクラス変数
obj1.animal_type = BigFish
obj2.animal_type = fish

ご覧のとおり、obj1.animal_typeだけが変更され、obj2.animal_typeは元の値「fish」のままです。これは意図した動作ではないことが多いでしょう。

クラス変数を正しく変更する方法

すべてのインスタンスに変更を反映させたい場合は、クラス名を使って直接クラス変数を変更します。先ほどのプログラムを修正してみましょう。

# Sharkクラスの定義
class Shark:
    animal_type = 'fish'  # クラス変数

    def __init__(self, name, age):
        self.name = name
        self.age = age

# Sharkクラスのオブジェクトを作成
obj1 = Shark("Jeeva", 54)
obj2 = Shark("Roli", 45)

print("2つのインスタンスからクラス変数を表示")
print("obj1.animal_type =", obj1.animal_type)
print("obj2.animal_type =", obj2.animal_type)

# クラス自体を通じてクラス変数を変更
Shark.animal_type = "BigFish"
print("新しいクラス変数の値は %s です（クラス経由で変更）" % (Shark.animal_type))

print("\nクラス経由で変更した後の各インスタンスの値")
print("obj1.animal_type =", obj1.animal_type)
print("obj2.animal_type =", obj2.animal_type)

実行結果

2つのインスタンスからクラス変数を表示
obj1.animal_type = fish
obj2.animal_type = fish
新しいクラス変数の値は BigFish です（クラス経由で変更）

クラス経由で変更した後の各インスタンスの値
obj1.animal_type = BigFish
obj2.animal_type = BigFish

まとめ

ポイントを整理すると、次のようになります。

• インスタンス経由での代入（例：obj1.animal_type = "BigFish"）は、そのインスタンス専用の新しいインスタンス変数を作成し、クラス変数を隠してしまう。
• クラス名経由での代入（例：Shark.animal_type = "BigFish"）を行えば、クラス変数そのものが更新され、すべてのインスタンスに反映される。
• 読み取りの場合はインスタンス経由でもクラス変数を参照できるが、代入時にはこの挙動の違いに注意が必要。

クラス全体で共有すべき値はクラス変数として定義し、変更する際は必ずクラス名を通じて行うことで、意図しないバグを防ぐことができます。