クラスの書き方を覚えて、selfにもようやく慣れてきた。そんなころに、メソッドの上に@classmethodや@staticmethodと書かれたコードに出会って、手が止まった経験はないでしょうか。
selfの代わりにclsと書いてあったり、引数にselfがまったくなかったりします。普通のメソッドと何が違うのか、いつ使えばいいのか、最初はとても迷いますよね。
この記事では、3種類のメソッドの違いを、動かせるサンプルコードで順番に確かめていきます。読み終わるころには、他人のコードで見かけても落ち着いて読めるようになるはずです。
サンプルの実行結果は、手元のLinux環境のPython 3.11で確認したものです。考え方そのものは、3.10以降のどのバージョンでも変わりません。
そもそもメソッドには3つの種類がある¶
まずは全体像からつかんでおきましょう。Pythonのクラスの中に書く関数、つまりメソッドには、大きく分けて3つの種類があります。
ふだん書いているselfを受け取るメソッドは、インスタンスメソッドと呼ばれます。これに加えて、クラスそのものを受け取るクラスメソッドと、何も自動では受け取らない静的メソッドがあります。
3つの違いを、次の表にまとめました。
| 種類 | 書き方 | 最初の引数 | 主な使いどころ |
|---|---|---|---|
| インスタンスメソッド | 何も付けない | self(インスタンス自身) | 一人ひとりのデータを読む・変える |
| クラスメソッド | @classmethod | cls(クラス自身) | 別の形のデータからインスタンスを作る |
| 静的メソッド | @staticmethod | なし | クラスに関係する小さな計算をまとめる |
ポイントは、最初の引数に何が自動で渡されるかという一点です。違いはこれだけと言ってもよく、使い分けもここから自然に決まります。
クラスやインスタンスという言葉に自信がない方は、先にこちらでクラスの基本を押さえておくと読みやすくなります。 【関連記事】継承・カプセル化・ポリモーフィズム。オブジェクト指向の3大要素をPythonで理解
3つのメソッドを1つのクラスで見比べる¶
言葉だけではイメージしにくいので、実際のコードを見てみましょう。ユーザーを表すクラスに、3種類のメソッドを1つずつ書いてみます。
class User:
count = 0 # クラス全体で共有する変数
def __init__(self, name, age):
self.name = name
self.age = age
User.count += 1
def greet(self): # インスタンスメソッド
return f"こんにちは、{self.name}です"
@classmethod
def from_csv(cls, line): # クラスメソッド
name, age = line.split(",")
return cls(name, int(age))
@staticmethod
def is_adult(age): # 静的メソッド
return age >= 18
u = User.from_csv("佐藤,25")
print(u.greet()) # こんにちは、佐藤です
print(User.is_adult(17)) # False
print(u.is_adult(20)) # True
print(User.count) # 1
greetは、そのユーザー自身の名前を使うのでselfが必要です。from_csvは、まだユーザーが存在しない段階で呼ばれ、新しいユーザーを作って返します。
is_adultは、年齢の数字だけで答えが決まる計算です。ユーザーの情報もクラスの情報も使わないので、何も受け取りません。
静的メソッドは、クラスからでもインスタンスからでも呼べる点も覚えておきましょう。どちらから呼んでも、結果は同じになります。
@classmethodとclsのしくみ¶
ここからは、それぞれをもう少し詳しく見ていきます。まずはクラスメソッドです。
@classmethodを付けたメソッドは、呼び出されたときにクラスそのものが最初の引数に入ります。この引数の名前は、慣習としてclsと書きます。
clsはclassの略です。classはPythonの予約語なので、そのままでは変数名に使えず、この綴りが定着しました。
別の形のデータからインスタンスを作る¶
クラスメソッドがいちばん活躍するのは、インスタンスの作り方を増やしたいときです。先ほどのfrom_csvのように、文字列や辞書からインスタンスを組み立てる入り口を用意できます。
__init__は1つしか書けないので、受け取れる形も1種類に決まってしまいます。そこでクラスメソッドを入り口として足すと、呼ぶ側はデータの形に合わせて選べるようになります。
実は、標準ライブラリにもこの形のメソッドがたくさんあります。名前がfromで始まるものが多いので、見分けやすいはずです。
| 呼び出し例 | 何をするか |
|---|---|
| dict.fromkeys(["a", "b"], 0) | キーの一覧から辞書を作る |
| int.from_bytes(b"\x01\x00", "big") | バイト列から整数を作る |
| date.fromisoformat("2026-11-16") | 文字列から日付を作る |
これらはどれも、クラスの名前から直接呼んでいます。インスタンスを作る前に呼べることこそが、クラスメソッドの持ち味です。
継承するとclsが子クラスに変わる¶
clsのありがたみがわかるのは、継承を使ったときです。先ほどのUserを継承して、管理者を表すAdminクラスを作ってみます。
class Admin(User):
pass
a = Admin.from_csv("鈴木,30")
print(type(a).__name__) # Admin
Admin.from_csvと呼ぶと、clsにはUserではなくAdminが入ります。そのため、何も書き足さなくても、ちゃんとAdminのインスタンスが返ってきます。
もしfrom_csvの中でcls(...)ではなくUser(...)と書いていたら、Adminから呼んでもUserが返ってしまいます。クラス名を直接書かずにclsを使うことで、子クラスでもそのまま使い回せるのです。
ちなみに、__init__の中のUser.countはUserと直接書いているので、Adminを作ったときも同じ変数が増えます。クラス変数を子クラスごとに分けたいのか、全体で共有したいのかは、書く前に決めておくと混乱しません。
@staticmethodはクラスに置いた普通の関数¶
続いて静的メソッドです。@staticmethodを付けると、selfもclsも渡されなくなります。
つまり中身は、クラスの中に置いてあるだけの普通の関数です。インスタンスのデータにもクラスのデータにも触れません。
それなら、わざわざクラスに入れる意味はあるのでしょうか。答えは、関係の深い処理を1か所にまとめて、読む人が探しやすくなる点にあります。
User.is_adultと書いてあれば、ユーザーにまつわる判定なのだとすぐに伝わります。モジュールのどこかにis_adultという関数が単独で置いてあるより、置き場所の意図がはっきりします。
ただし、静的メソッドは本当に必要なのかと議論になりやすい機能でもあります。モジュールに普通の関数として置くほうがPythonらしい、という考え方も根強くあります。
私は10年ほどエンジニアとして開発に関わってきましたが、新人のころに、何でも静的メソッドにまとめた巨大なクラスを作ったことがあります。レビューで、それはクラスではなく関数の詰め合わせだと指摘され、モジュールの関数に分け直したのはいい教訓でした。
どれを使えばいいか迷ったときの判断基準¶
ここまでで、3つの違いはつかめてきたと思います。実際にコードを書くときは、メソッドの中で何を使うかを見て決めるのがいちばん確実です。
判断の流れを、次の表にまとめました。
| メソッドの中で使うもの | 選ぶ種類 |
|---|---|
| self.nameなど、インスタンスのデータ | インスタンスメソッド |
| クラス自身(新しいインスタンスを作る、クラス変数を読む) | クラスメソッド |
| 引数だけ。インスタンスもクラスも使わない | 静的メソッド、またはモジュールの関数 |
迷ったら、まずは普通のインスタンスメソッドで書いてみてください。ほとんどのメソッドはインスタンスメソッドで足りますし、あとから変えるのも難しくありません。
selfを一度も使っていないと気づいたら、そこで初めてほかの2つを検討します。エディタやリンターが、selfを使っていないメソッドとして知らせてくれることもあります。
初心者がつまずきやすいポイント¶
考え方がわかっても、実際に書くと思わぬところでエラーに出会います。よくあるつまずきを2つ紹介します。
デコレータを付け忘れる¶
いちばん多いのが、@classmethodや@staticmethodの書き忘れです。たとえば静的メソッドのつもりで、デコレータを付けずに書いたとします。
class Calc:
def double(x): # @staticmethodを付け忘れた
return x * 2
c = Calc()
c.double(3)
# TypeError: Calc.double() takes 1 positional argument but 2 were given
インスタンスから呼ぶと、Pythonはc自身を最初の引数として自動で渡します。そのため、引数は1つのはずなのに2つ渡された、というエラーになるのです。
引数の数が1つ多いと言われたら、デコレータの付け忘れを疑ってみてください。デコレータそのものの仕組みが気になる方は、こちらの記事で詳しく解説しています。 【関連記事】Pythonのデコレータ(@)って何?関数の前後で処理を追加する不思議な記法の正体
クラスメソッドからselfは使えない¶
もう1つは、クラスメソッドの中でインスタンスのデータを読もうとしてしまう失敗です。clsはクラスなので、cls.nameのように一人ひとりの名前を取り出すことはできません。
インスタンスのデータが必要なら、それはインスタンスメソッドで書くべき処理です。最初の引数に何が入るのかを思い出せば、迷わずに済みます。
@propertyとの組み合わせとバージョンによる違い¶
ここは少し発展的な話です。メソッドを属性のように見せる@propertyと、クラスメソッドを重ねて書くテクニックがありました。
@classmethodの上に@propertyを重ねると、クラスから直接呼べるプロパティのように使えました。この書き方はPython 3.9で使えるようになりましたが、3.11で非推奨となり、3.13で削除されています。
古い記事やコードでこの書き方を見かけても、新しいバージョンでは期待どおりに動きません。同じことをしたい場合は、クラス変数を使うなど別の方法を選びましょう。
一方で、Python 3.10では静的メソッドが少し便利になりました。クラスの中から普通の関数として直接呼べるようになり、元の関数を指す__wrapped__という属性も持つようになっています。
@property自体の使い方は、こちらの記事で基本から紹介しています。 【関連記事】Pythonの@propertyとは?メソッドを属性の顔で使わせる書き方を初心者向けに解説
実務でよく見かける使い方¶
最後に、実際の開発でよく見かける形を紹介します。いちばん多いのは、設定ファイルやAPIの結果からオブジェクトを作るクラスメソッドです。
from_dictやfrom_jsonといった名前で、辞書を受け取ってインスタンスを返す形がよく使われます。データの形が変わっても、そのクラスメソッドだけを直せば済むので、修正の範囲が小さくなります。
私の現場でも、外部APIの返す項目名が変わったときに、この形で助けられたことがあります。変換処理がfrom_dictの1か所にまとまっていたおかげで、半日かかると思っていた修正が数十分で終わりました。
データを入れておくクラスを手早く作りたいなら、dataclassと組み合わせるのもおすすめです。__init__を自動で作ってもらい、入り口だけをクラスメソッドで足すと、短くて読みやすいクラスになります。 【関連記事】Pythonのdataclassとは?クラスの定義がぐっと短くなる書き方を初心者向けに解説
まとめ¶
Pythonのメソッドには、インスタンスメソッド・クラスメソッド・静的メソッドの3種類があります。違いは、最初の引数にインスタンスが入るか、クラスが入るか、何も入らないかです。
クラスメソッドは、別の形のデータからインスタンスを作る入り口として活躍します。clsを使っておけば、継承した子クラスでもそのまま正しく動きます。
静的メソッドは、クラスに関係の深い小さな処理をまとめる場所です。ただし、モジュールの関数で十分なことも多いので、使いすぎには気をつけましょう。
迷ったときは、メソッドの中で何を使っているかを確かめてください。それだけで、どれを選ぶべきかはほとんど決まります。
ここまでお読みいただきありがとうございました。