Pythonでクラスを学び始めると、必ず登場するのが @classmethod と @staticmethod という2つのデコレーター。普通のメソッドと何が違うのか、いつ使えばいいのか、最初は戸惑いますよね。
でもこの2つを使い分けられるようになると、コードの見通しが一気に良くなり、「このクラスに関連する処理だな」と一目で分かる読みやすい設計ができるようになります。Pythonの標準ライブラリ（datetimeなど）でも実際に使われている考え方なので、押さえておく価値は十分です。✨
クラスのメソッドとは、クラスが持っている関数のこと。たとえば書籍を表す Book クラスに、__init__（イニシャライザ）と display_info というメソッドを定義したとします。
呼び出すときは book = Book(...) のようにオブジェクトを作って、book.display_info() という形でアクセスします。ここまでは普通のクラスの話ですね。📚
staticメソッドは、オブジェクトを作らずに呼び出せる少し特殊なメソッドです。第1引数に self を取らず、関数のような感覚で書ける点が大きな特徴。メソッドの上に @staticmethod デコレーターを付けるだけで定義できます。
たとえば「Bookオブジェクトのリストを価格順に並び替える」処理を、Bookクラスのstaticメソッド sort_books_by_price として実装するとこんなイメージです。
@staticmethod
def sort_books_by_price(books):
return sorted(books, key=lambda b: b.price)
呼び出すときは Book.sort_books_by_price([book1, book2, book3]) のように、クラス名から直接呼べるのがポイント。普通の関数感覚ですね。⚡
機能面では、クラスの外に普通の関数として定義しても同じことができます。でもあえてstaticメソッドにする意味は、「そのクラスに関連する処理だ」と明示できること。コードを読む人にとって、「この処理はBookに関係するんだな」と一目で分かる設計上のメリットがあります。👀
classmethodも、オブジェクトを作らずに呼び出せるメソッドという点ではstaticメソッドと似ていますが、決定的な違いがあります。それは第1引数に「クラス自身」が自動で渡されること。慣習的に cls という変数名を使います。
classmethodの代表的な使い方が Factory Method（ファクトリメソッド）。「JSON文字列からBookオブジェクトを作る」ような、オブジェクト生成の代替手段として使われます。
@classmethod
def from_json(cls, book_json):
data = json.loads(book_json)
return cls(data["title"], data["author"], data["price"])
呼び出すときは book1 = Book.from_json('{"title":"...", ...}') のように、クラス名からダイレクトに呼べます。これでJSONデータから一発でBookオブジェクトが生成できるわけですね。🎯
「自分のクラス名を直接書けば良いのでは？」と思いますよね。あえて cls を使う理由は、継承したサブクラスでも正しく動くようにするためです。
たとえば Book を継承した Comic や PhotoBook クラスがあるとします。Comic.from_json(...) を呼ぶと、cls には自動的に Comic が入るので、Comicクラスのオブジェクトが返ってくるのです。staticメソッドで Book(...) と直書きしてしまうと、サブクラスから呼んでも常にBookしか返らず、継承の旨味が消えてしまいます。⚠️
「クラスメソッドってホントに使うの？」と思うかもしれませんが、Python標準ライブラリの datetime モジュールがまさにこのパターンです。
同じ today() でも、呼び出すクラスに応じて適切な型のオブジェクトが返ってくる。これがclassmethodをFactory Methodとして使う恩恵です。✨
「迷ったらまず普通のメソッド」「クラスを直接使う必要があればclassmethod」「どちらでもないけどクラスに紐づけたいならstaticmethod」と覚えると整理しやすいです。🧭
サブクラスでイニシャライザの引数が増えた場合、親クラスのFactory Methodをそのまま継承すると引数の数が合わずうまく拡張できないことがあります。便利ですが、拡張性を損なう場合があるので、設計時には派生クラスでも問題なく動くか確認しましょう。
動画やブログで概念をつかんだあとは、書籍で体系的に学ぶのが定着への近道。クラス設計、継承、デザインパターン、Pythonらしい書き方まで一気に押さえておくと、実務で「ここはclassmethodが綺麗だな」と判断できる力がついてきます。📈
Pythonの特殊メソッド・クラス設計・デコレーターまで深く解説した名著。@classmethodや@staticmethodの実例も豊富で、読み応え抜群です。
クラス・デコレータ・メタクラスといったPythonらしい書き方を90項目で網羅。「classmethodをいつ使うべきか」の判断軸が身につきます。
クラス間の責務分担、継承の使いどころ、Factory Methodなどのパターンを丁寧に解説。Pythonに限らず通用する設計の地力が育ちます。
Factory Methodをはじめ、現場で頻出する設計パターンをカタログ的にまとめた1冊。クラスメソッドを使った設計の引き出しが増えます。
「読みやすいコードとは何か」を体系的に学べる古典。staticmethodで処理を整理する判断にも、この感覚は必ず役立ちます。
クラス自体を扱う必要があるならclassmethod、不要ならstaticmethodです。代替コンストラクタやサブクラスから呼ぶことを想定しているならclassmethod一択。シンプルなユーティリティ関数ならstaticmethodで十分です。
必須ではありませんが、継承を想定する場合はclassmethodが安全です。staticmethodで自クラス名を直書きすると、サブクラスから呼んでも親クラスのオブジェクトしか返らず、継承の意味が薄れてしまいます。
機能的には同じですが、クラスのメソッドにすることで「このクラスに関連する処理」と明示できるのが大きな違い。コードを読む人や将来の自分にとって、見通しの良さが格段に上がります。
動作上は変えても動きますが、慣習的に「cls」を使うのが強く推奨されています。selfと同じく、Pythonコミュニティ全体での共通理解を保つためにも、変えずに使いましょう。
呼べます。book.from_json(...) のようにインスタンス経由でも呼び出し可能です。ただし、Factory Methodとして使う場合はクラス名から呼ぶ方が意図が明確で読みやすくなります。
Pythonの @classmethod と @staticmethod は、最初こそ「ややこしい」と感じるかもしれませんが、一度仕組みを理解すれば「なるほど、ここはこう書くと綺麗だな」と判断できる強力な武器になります。🛠
動画やブログだけで腑に落ちないところは、書籍で繰り返し読んで手を動かすのが一番。今回紹介した書籍を相棒に、ぜひあなたのPythonコードを「読みやすく、拡張しやすい設計」へとレベルアップさせてみてください。🚀