Mixin类应显式继承object且不定义__init__，仅提供可复用方法，避免状态和初始化逻辑；通过isinstance判断能力，不依赖super()调用，优先级低于ABC。
Mixin 类必须继承自 object 且不定义 __init__
Mixin 的本质是提供可复用的方法，不是独立实体；一旦定义了 __init__，就容易和主类的初始化逻辑冲突，尤其在多继承 MRO（方法解析顺序）中引发重复调用或遗漏。Python 3 中所有类默认继承 object，但显式写明更清晰，也避免在旧代码迁移时出错。
常见错误：在 Mixin 里写 __init__(self, x)，结果主类调用 super().__init__() 时意外触发 Mixin 初始化，参数对不上直接报 TypeError: __init__() takes 2 positional arguments but 3 were given。
- 只放方法（
def），不放状态（self.xxx =）或初始化逻辑 - 若需配置，改用类属性（
default_timeout = 30）或通过主类传参后由主类处理 - 方法内部一律用
self访问属性——Mixin 不保证这些属性存在，由使用者确保继承链上已有对应属性
使用 isinstance(obj, MixinClass) 判断能力而非类型
Mixin 不代表一种“类型”，而是声明“具备某组行为”。比如 JSONSerializableMixin 表示能 to_json()，但你不该用 type(obj) is JSONSerializableMixin——它根本不能被实例化。
典型误用场景：写 API 路由时，想过滤出所有支持导出的模型，结果用 issubclass(cls, JSONSerializableMixin) 没问题，但用 isinstance(instance, JSONSerializableMixin) 才是运行时真正可用的判断方式（只要该实例所属类继承了 Mixin）。
立即学习“Python免费学习笔记（深入）”；
- 检查能力用
hasattr(obj, 'to_json')或isinstance(obj, YourMixin)（前提是 Mixin 是普通类，非抽象基类） - 避免在 Mixin 内部做
isinstance(self, SomeOtherMixin)——这会造成隐式耦合 - 如果需要组合多个 Mixin 行为，靠方法名冲突检测（如两个 Mixin 都定义
save()）比运行时类型检查更实际
避免在 Mixin 中调用 super().method() 除非明确设计为钩子
大多数 Mixin 方法是“原子能力”，比如 log_action()、cache_result()，它们不依赖父类实现。一旦写 super().fetch_data()，就要求所有继承链上的类都实现 fetch_data，这违背了 Mixin 的轻量复用原则。
只有当 Mixin 明确作为“增强层”存在（如 LoggingMixin 包裹原有 process()），才应设计成钩子模式：主类方法先调用 super().process()，Mixin 的 process() 再调用 super().process() 并前后插入逻辑。否则就是把 Mixin 写成了抽象基类。
- 钩子型 Mixin 必须文档注明“需配合
super()调用”，并在示例中展示完整继承链 - 普通功能型 Mixin（如
DictConvertibleMixin）绝不出现super()调用 - 用
getattr(self, 'some_attr', None)替代硬性依赖，让使用者决定是否提供
复杂业务中 Mixin 的优先级比抽象基类（ABC）低
当你的系统需要强制约束接口（比如所有支付网关必须实现 charge() 和 refund()），用 abc.ABC + @abstractmethod 更合适。Mixin 适合“锦上添花”，不适合“划清底线”。强行用 Mixin 实现契约，会导致子类忘记继承、方法名拼错、或覆盖后不调用 super，而这些错误在运行时才暴露。
一个信号：如果你发现自己在 Mixin 里写大量 if not hasattr(self, 'xxx'): 或反复解释“这个方法你应该自己实现”，说明它已经越界了。
- ABC 用于定义“必须做什么”，Mixin 用于定义“可以怎么做得更好”
- 混合使用时，ABC 放继承列表最左，Mixin 放右（因 MRO 从左到右查找，ABC 约束优先）
- 测试 Mixin 时，别测它自己，测“继承它的类是否真的获得了预期方法”
真正难的是判断某个功能到底该抽成 Mixin、ABC、还是独立工具函数。边界模糊时，先写成函数；需要共享状态或绑定到实例时，再考虑 Mixin；必须统一接口规范时，才上 ABC。
