类方法中不能直接调用实例方法，因缺少self；应将共用逻辑提取为静态方法，通过cls调用以支持继承。
类方法里不能直接调用实例方法
类方法（@classmethod）的第一个参数是 cls，不是 self，它没有访问实例状态的能力。所以如果你在 @classmethod 里写 self.some_instance_method()，会报 NameError: name 'self' is not defined；就算硬传了 self，也会因缺少实例上下文而失败。
常见错误场景：想在类方法中复用已有逻辑，比如初始化前校验、预处理字段，但误把实例方法当工具函数调用。
- 实例方法必须通过实例调用，例如
obj.method() - 类方法内部若需等效功能，应把逻辑抽成静态方法（
@staticmethod）或独立函数 - 强行用
cls().instance_method()创建临时实例虽语法可行，但可能触发不必要的初始化（如__init__中有副作用），且违背设计意图
优先用 @staticmethod 拆分可复用逻辑
如果某段逻辑不依赖 self 或 cls 的状态（比如字符串清洗、数值转换、格式校验），就该定义为 @staticmethod，这样类方法和实例方法都能直接调用。
class User:
@staticmethod
def _normalize_email(email):
return email.strip().lower()
@classmethod
def from_email(cls, email):
clean = cls._normalize_email(email) # ✅ 正确：静态方法可被类方法直接调用
return cls(clean)
def __init__(self, email):
self.email = self._normalize_email(email) # ✅ 实例方法也能调用
立即学习“Python免费学习笔记（深入）”；
注意：_normalize_email 前加下划线是约定，表示“内部工具”，不是强制限制；它不绑定任何对象，纯粹是逻辑复用节点。
需要访问类属性时，统一走 cls.xxx
类方法中访问类变量、类方法或子类重写的属性，必须通过 cls，而不是类名硬编码。否则继承时会出错。
- ✅ 正确：
cls.DEFAULT_ROLE、cls.create_default_user() - ❌ 危险：
User.DEFAULT_ROLE—— 若子类AdminUser覆盖了DEFAULT_ROLE，这个调用仍返回父类值 - ❌ 错误：
self.some_class_attr——self在类方法中根本不存在
示例：
class Model:
table_name = "models"
@classmethod
def get_table(cls):
return cls.table_name # ✅ 支持子类覆盖
class Post(Model):
table_name = "posts"
print(Post.get_table()) # 输出 "posts"，不是 "models"
调用其他 @classmethod 时用 cls.method_name()
同一个类里的其他类方法，可以通过 cls.方法名() 调用；跨类则用目标类名（前提是设计上允许耦合）。
- 同个类内推荐用
cls，保持对子类友好 - 避免写
User.create_from_dict(...)，改用cls.create_from_dict(...) - 若被调用的类方法有参数，注意它是否依赖当前类的特定实现（比如硬编码了某个类名或路径）
容易忽略的一点：类方法之间调用不自动传递 cls，你得显式传——但 cls.方法名() 本身已隐含绑定，无需额外传参。
真正麻烦的是多层继承 + 类方法组合调用，这时候要检查每层是否都正确使用 cls，否则一不小心就掉回父类作用域。