该用 @classmethod 的地方误写 @staticmethod 会导致子类继承时 silently 失效，因 @classmethod 自动传入实际调用者类（cls），支持类属性访问、继承与多态，而 @staticmethod 无隐式参数、不参与 mro、无法动态适配子类。
别用错：该用 @classmethod 的地方写成 @staticmethod，子类一继承就 silently 失效。
调用时参数自动传入规则完全不同
你写的那个方法，Python 怎么知道该传什么？全看装饰器：
-
@classmethod方法必须带cls参数，Python 自动把「实际调用者类」塞进去——哪怕你是用子类实例调的，cls也是子类，不是父类，更不是硬编码的类名 -
@staticmethod方法没有隐式参数，cls或self都不会自动传；你写def foo(x)，就真的只收一个x - 两者都支持
Class.method()和obj.method()，但背后行为天差地别：前者传类，后者对@classmethod仍传obj.__class__，对@staticmethod还是啥都不传
访问类属性或调用其他类方法？只能用 @classmethod
常见错误是：想改类变量、读配置、复用另一个 @classmethod，却写了 @staticmethod，结果要么报错，要么逻辑错得悄无声息：
-
@classmethod可直接用cls.count += 1或cls.create_from_json()，天然支持继承 -
@staticmethod想访问类属性？只能硬写MyClass.config——类名一改，全挂；子类想覆盖配置？做不到 - 典型误用：数据库连接工厂、序列化构造器、策略分发入口——这些本该感知调用者类，却用静态方法锁死了扩展性
真只是工具函数？才考虑 @staticmethod
别因为“没用到 self”就急着加 @staticmethod。先问自己：
- 这个函数会不会未来需要根据子类切换行为？（比如不同子类返回不同格式的 JSON）→ 选
@classmethod - 它是否纯计算，完全不依赖任何类结构？比如
is_valid_email()、to_celsius(f)、parse_iso_date(s)→ 才适合@staticmethod - 它会不会被子类重写？
@staticmethod不参与 MRO 查找，子类同名方法不会覆盖父类的——这不是多态，是遮蔽
不确定时，默认用 @classmethod
成本几乎为零，但灵活性拉满：
- 现在没用
cls？没关系，先加上；以后加日志、加策略分支、加子类适配，一行都不用改调用方 - 想退化成静态？删掉
cls参数再加@staticmethod就行；反过来，从静态改类方法要动签名、改内部引用，还可能破坏已有调用 - 标准库里
@classmethod数量是@staticmethod的近两倍——不是偶然，是经验沉淀
最易被忽略的一点：类方法的 cls 是动态的，它不等于定义时的类，而是等于「此刻真正发起调用的那个类」。这个动态性一旦被静态方法抹掉，子类就失去了一切可定制机会——而这种 bug 往往上线后才暴露，且难以定位。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
