Pythonでクラススコープに変数を定義する適切な方法とは？クラス属性とインスタンス属性の違いを解説

Pythonでは、クラス本体の中で直接変数を定義することで、いわゆる「クラススコープを持つ変数」（クラス属性・クラス変数）を作成できます。このクラス属性は、そのクラスのすべてのインスタンスから参照できる共有変数として機能します。

ただし、インスタンス経由での代入と、クラス経由での代入では挙動が異なるため、その違いを正しく理解しておくことが重要です。

基本的な使い方

以下のコードは、クラススコープ内でクラス属性を定義し、それを参照・変更する例です。

class Foo(object):
    bar = 2  # クラス属性の定義

foo = Foo()
print(Foo.bar)  # 2
print(foo.bar)  # 2

# foo.bar への代入はクラス属性 bar を変更しない
# 代わりにインスタンス自身に新しい属性が作成される
foo.bar = 3
print(Foo.bar)  # 2（クラス属性は変わらない）
print(foo.bar)  # 3（インスタンス属性が優先される）

# クラス属性を変更したい場合は、クラス経由でアクセスする
Foo.bar = 4
print(Foo.bar)  # 4
print(foo.bar)  # 3（インスタンス属性があるためこちらが優先される）

実行結果

2
2
2
3
4
3

ポイント解説

1. クラス属性の定義

クラスブロック内に bar = 2 のように記述すると、それはクラスオブジェクト自体に属する属性になります。すべてのインスタンスから Foo.bar または foo.bar の形式で参照できます。

2. インスタンスへの代入は「上書き」ではなく「新規作成」

foo.bar = 3 とした場合、クラス属性 bar が書き換わるわけではありません。代わりに、そのインスタンス専用の新しい属性が作成され、以降 foo.bar を参照するとインスタンス属性が優先されます。

3. クラス属性を変更するにはクラス名を使う

クラス属性そのものを更新したい場合は、Foo.bar = 4 のように必ずクラス名を通じてアクセスします。これにより、まだインスタンス属性を持たない他のインスタンスにも変更が反映されます。

まとめ

クラススコープで共有変数を定義したい場合は、クラス本体に直接記述するのがPythonの標準的な作法です。読み取りはインスタンスからでも可能ですが、値の変更はクラス名経由で行うことで、意図しないインスタンス属性の生成を防ぎ、コードの挙動を明確にできます。