实例方法必须带self且只能通过实例调用;@classmethod必须带cls,类和实例均可调用;@staticmethod无隐式参数,适用于不依赖实例或类的纯函数。

实例方法必须带 self,且只能通过实例调用
当你定义一个普通方法(没加任何装饰器),Python 会默认把它当实例方法处理。这个方法的第一个参数必须是 self,它在调用时由解释器自动传入——你写 obj.method(),Python 就把 obj 塞进 self;但如果你试图用 Class.method() 调用,就会报 TypeError: method() missing 1 required positional argument: 'self'。
常见错误现象:
- 直接用类名调用实例方法,比如
Student.introduce(),结果抛错 - 手动传了
self,比如obj.introduce(obj),导致参数重复 - 在方法体里漏掉
self.前缀,比如写成name而不是self.name,结果访问的是局部变量或触发NameError
@classmethod 方法必须带 cls,类和实例都能调用
@classmethod 的本质是让方法“绑定到类”,而不是某个具体对象。它的第一个参数是 cls,代表当前被调用的类(注意:如果子类继承后调用,cls 是子类,不是父类)。这意味着你可以安全地用 Class.method() 或 instance.method(),都不会出错。
使用场景:
立即学习“Python免费学习笔记(深入)”;
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
- 实现替代构造器,比如
from_json()、from_string()这类工厂方法 - 修改类属性(如计数器、配置开关)
- 需要动态创建本类或子类实例(用
cls(...))
容易踩的坑:
- 误以为
cls是固定指父类——其实它总是运行时实际调用者的类 - 在
@classmethod里尝试访问self.name,会报NameError,因为根本没self - 混淆
cls和type(self):前者是显式传入的类对象,后者是在实例方法里推导出的类型,语义不同
self 和 cls 都不是关键字,但别乱改名
Python 不强制你用 self 或 cls,它们只是约定。你可以写 def greet(this): 或 @classmethod def init(cls_):,语法上完全合法。但几乎所有主流代码库、文档、IDE 提示都基于这两个名字做识别。
后果很实际:
- PyCharm、VS Code 等工具对非标准名可能不提示实例属性补全
- 静态检查工具(如 mypy)默认只认
self/cls,否则报错或跳过检查 - 团队协作中突然换成
me或klass,别人第一眼会愣住,降低可读性
什么时候该用 @staticmethod 而不是 @classmethod?
如果一个方法既不依赖实例状态(不用 self),也不依赖类本身(不用 cls),比如纯计算、数据校验、格式转换,那就该用 @staticmethod。它没有隐式参数,调用方式最自由,但代价是失去了对类/实例的任何引用能力。
典型误用:
- 想在静态方法里改类变量——不行,得换
@classmethod - 想根据输入字符串决定返回哪个子类实例——静态方法做不到动态分发,必须用
cls+cls(...) - 为了“看起来整洁”把所有工具函数都塞进类里却不加装饰器——那其实是实例方法,调用时仍要传实例,纯属自找麻烦
cls 在继承链中是动态的,而实例方法里的 self 类型虽然也是动态的,但访问逻辑依赖于实例已存在。这两者在多态行为上的差异,往往要到写抽象基类或元类时才明显暴露出来。

















