该用 @classmethod 做工厂方法当需返回调用者类（含子类）实例：它接收运行时 cls，支持继承与多态；@staticmethod 无 cls，无法适配子类，仅适合无关类的纯辅助逻辑。
什么时候该用 @classmethod 做工厂方法？
当你需要返回当前类或其子类的实例，且希望子类继承工厂方法后自动构造自身类型时，必须用 @classmethod。它接收隐式的 cls 参数，而不是硬编码类名。
常见错误是写成普通静态方法再手动写死类名，比如 return MyClass(...)——这样子类调用时仍返回父类实例，违背工厂本意。
- 适用场景：从字符串解析、从配置字典构建、根据类型标识符创建不同子类实例
- 关键点：
cls是运行时实际调用者的类（可能是子类），不是定义该方法的类 - 性能无额外开销，语义清晰，是 Python 官方推荐的“可继承工厂”写法
示例：
class Shape:
def __init__(self, name):
self.name = name
<pre class="brush:php;toolbar:false;">@classmethod
def from_json(cls, data):
return cls(name=data.get("name", "unknown"))class Circle(Shape): pass
c = Circle.from_json({"name": "round"}) # 返回 Circle 实例，不是 Shape
为什么 @staticmethod 不适合多数工厂场景？
@staticmethod 本质就是普通函数，只是挂载在类上；它不接收 cls 或 self，无法感知调用者是谁。强行用它做工厂，等于放弃多态能力。
立即学习“Python免费学习笔记（深入）”；
你可能会看到类似这样的代码：
@staticmethod
def create_circle(name):
return Circle(name)
这看起来像工厂，但它和把函数写在模块顶层没区别，不能被子类复用或重载——子类调用 Circle.create_circle() 没问题，但 Square.create_circle() 就逻辑错乱了。
- 仅适合：完全与类无关的辅助构造逻辑（如校验输入格式、预处理原始数据）
- 典型误用：用
@staticmethod替代@classmethod来“绕过 cls”，结果导致子类无法正确实例化 - 兼容性没问题，但设计意图被破坏，后续扩展成本高
混合使用时怎么避免参数混乱？
一个类里既有 @classmethod 工厂，又想封装一些通用预处理逻辑，容易把校验逻辑也塞进 @classmethod 导致臃肿。这时可将纯逻辑抽到 @staticmethod 中，由 @classmethod 调用。
-
@staticmethod处理无状态转换：比如parse_date_string(s)、normalize_config(d) -
@classmethod负责“决定造什么”和“用什么造”，调用静态方法获取中间结果 - 注意别让
@staticmethod返回类实例——那它就该是@classmethod
示例：
class User:
def __init__(self, name, joined_at):
self.name = name
self.joined_at = joined_at
<pre class="brush:php;toolbar:false;">@staticmethod
def _parse_iso_date(date_str):
from datetime import datetime
return datetime.fromisoformat(date_str)
@classmethod
def from_api_response(cls, resp):
dt = cls._parse_iso_date(resp["joined"])
return cls(name=resp["username"], joined_at=dt)
容易被忽略的继承细节：__new__ 和 @classmethod 的协作
如果类重写了 __new__，@classmethod 工厂方法仍能正常工作，因为 cls(...) 最终会触发 cls.__new__(cls, ...)。但要注意：若 __new__ 返回的不是 cls 实例（比如返回缓存对象或父类实例），工厂方法的行为就会偏离预期。
- 调试线索：工厂方法返回了意外类型？先检查
__new__是否有非标准返回 - 子类覆盖
@classmethod时，若需调用父类逻辑，用super().from_xxx(...)，而非ParentClass.from_xxx(...) - 单元测试时务必用子类调用工厂方法，验证返回类型是否符合预期——这是最容易漏掉的测试点
工厂方法的复杂度不在语法，而在调用链中哪一环真正决定了实例类型。盯住 cls 的实际值，比记住装饰器规则更重要。
