Pythonのデコレータ（@staticmethod / @classmethod）の使い方を完全ガイド！初心者でもわかるクラスメソッド入門

1. Pythonのデコレータとは？

1. Pythonのデコレータとは？

Python（パイソン）のデコレータとは、「関数やメソッドの動きを少し変えるための仕組み」です。見た目は@から始まる特別な記号で、関数やメソッドの直前に書きます。

初心者の方は、「これはこの関数の役割を説明するラベル」くらいに考えると分かりやすいです。難しい仕組みを理解しなくても、使い方を覚えれば問題ありません。

2. クラスとメソッドの基本をおさらい

2. クラスとメソッドの基本をおさらい

クラスとは、現実世界の「もの」をプログラムで表現した設計図です。例えば「人」や「商品」などをクラスとして表します。

メソッドとは、そのクラスが持つ「動作」です。Pythonでは、通常のメソッドはselfという特別な引数を使って、自分自身の情報にアクセスします。

class Person:
    def say_hello(self):
        print("こんにちは")

このselfは、「この人自身」という意味を持つ重要なキーワードです。

3. @staticmethodとは？

3. @staticmethodとは？

@staticmethod（スタティックメソッド）は、「クラスに属しているが、インスタンスの情報を使わないメソッド」です。

例えるなら、「道具箱に入っている便利な計算機」のような存在です。誰が使っても同じ結果になり、個人差は関係ありません。

class Calculator:
    @staticmethod
    def add(a, b):
        return a + b

result = Calculator.add(3, 5)
print(result)

8

このように、selfを使わず、クラス名から直接呼び出せるのが特徴です。

4. @staticmethodを使う場面

4. @staticmethodを使う場面

@staticmethodは、「クラスと関係はあるが、個々のデータを使わない処理」に向いています。例えば、入力チェックや単純な計算処理などです。

class UserCheck:
    @staticmethod
    def is_adult(age):
        return age >= 20

print(UserCheck.is_adult(18))
print(UserCheck.is_adult(25))

False
True

このように、状態を持たず、判断だけを行う処理にぴったりです。

5. @classmethodとは？

5. @classmethodとは？

@classmethod（クラスメソッド）は、「クラスそのものの情報を使うメソッド」です。引数にはclsが渡され、これはクラス自身を表します。

例えるなら、「クラス全体のルールを管理する責任者」のような存在です。

class School:
    school_name = "ひまわり学園"

    @classmethod
    def show_school_name(cls):
        print(cls.school_name)

6. @classmethodの具体例

6. @classmethodの具体例

@classmethodは、クラス変数（クラス全体で共有する値）を扱うときによく使われます。

class Counter:
    count = 0

    @classmethod
    def increment(cls):
        cls.count += 1

Counter.increment()
Counter.increment()
print(Counter.count)

2

このように、クラス全体の状態を管理できるのが特徴です。

7. 通常メソッド・@staticmethod・@classmethodの違い

7. 通常メソッド・@staticmethod・@classmethodの違い

三つのメソッドの違いを簡単にまとめると、次のようになります。

• 通常メソッド：自分自身（self）を使う
• @staticmethod：クラスの補助機能
• @classmethod：クラス全体の情報を扱う

この使い分けを意識することで、Pythonのオブジェクト指向がぐっと分かりやすくなります。

8. 初心者がつまずきやすいポイント

8. 初心者がつまずきやすいポイント

初心者の方は、「全部普通のメソッドでいいのでは？」と感じがちです。しかし、役割ごとに分けることで、後から見返したときに意味がすぐ分かるコードになります。

特にチーム開発や長いプログラムでは、この違いが大きな助けになります。