Pythonの静的メソッド（@staticmethod）とは？仕組みと使い方を解説

Pythonのクラスには、インスタンスメソッド、クラスメソッド、静的メソッド（スタティックメソッド）という3種類のメソッドを定義できます。それぞれ役割や呼び出し方が異なり、適切に使い分けることでコードの可読性と保守性が向上します。

3種類のメソッドの違い

• インスタンスメソッド： 第1引数に self を受け取り、オブジェクト（インスタンス）の状態にアクセス・変更できます。
• クラスメソッド： @classmethod デコレータを付け、第1引数に cls を受け取り、クラス自体の状態にアクセスできます。
• 静的メソッド： @staticmethod デコレータを付け、self も cls も受け取りません。

コード例

以下のコードで、3種類のメソッドがどのように定義されるかを見てみましょう。

class OurClass:
    def method(self):
        return 'instance method called', self

    @classmethod
    def classmethod(cls):
        return 'class method called', cls

    @staticmethod
    def staticmethod():
        return 'static method called'

3番目のメソッド OurClass.staticmethod には @staticmethod デコレータが付いており、これによって静的メソッドとして扱われます。

静的メソッドの特徴

静的メソッドは self や cls のような特別な第1引数を受け取らず、代わりに任意の数の通常の引数を渡すことができます。

そのため、静的メソッドはオブジェクトの状態もクラスの状態も変更できません。アクセスできるデータが制限されており、主な用途はメソッドをクラス内で名前空間として整理することです。つまり、クラスに論理的に関連するユーティリティ関数をまとめるために使われます。

静的メソッドの呼び出し方

上記のコードの静的メソッドは、次のように呼び出せます。

>>> obj = OurClass()
>>> obj.staticmethod()
'static method called'

このように、インスタンスを作成してから呼び出すこともできますし、OurClass.staticmethod() のようにクラスから直接呼び出すことも可能です。

まとめ

静的メソッドは、インスタンスやクラスの状態に依存しない処理を定義するのに便利な機能です。「このクラスに関連するが、状態は必要ない」というヘルパー関数を配置する際に活用すると、コードの構造がより明確になります。