本文深入解析 Python 多重继承下 __init_subclass__ 的调用逻辑，阐明为何它默认只触发一次、如何通过显式 super() 调用实现所有父类的协同初始化，并提供可运行示例与关键注意事项。
本文深入解析 python 多重继承下 `__init_subclass__` 的调用逻辑，阐明为何它默认只触发一次、如何通过显式 `super()` 调用实现所有父类的协同初始化，并提供可运行示例与关键注意事项。
在 Python 3.6+ 引入的 __init_subclass__ 是一个强大的类创建钩子，用于在子类定义完成（但尚未实例化）时自动执行初始化逻辑。然而，当一个类同时继承多个具有 __init_subclass__ 的父类时，开发者常误以为该方法会“自动”为每个父类各调用一次——事实并非如此。其行为严格遵循 Python 的方法解析顺序（MRO） 和显式协作机制，而非隐式广播。
? 核心原理：MRO 驱动 + 显式协作
__init_subclass__ 并非由解释器对每个基类单独调用，而是在类创建过程中，由 type.__new__ 在构建完新类对象后，仅调用一次 `super(cls, cls).__init_subclass__(kwargs)**。该调用依据当前类的 MRO 查找第一个定义了init_subclass的父类，并执行其方法。若该方法内部未主动调用super().init_subclass()`，则链式传递中断，后续基类中的同名方法将被跳过。
以问题中的 MyClass(ClassOne, ClassTwo) 为例，其 MRO 为：
[MyClass, ClassOne, ClassTwo, object]
因此，type 会首先查找并调用 ClassOne.__init_subclass__；若 ClassOne 中未写 super().__init_subclass__()，ClassTwo 的钩子永远不会被执行。
✅ 正确做法：构建协作链
要确保所有父类的 __init_subclass__ 均被调用，每个定义该方法的类都必须显式委托给 super()，形成一条向 MRO 深处传递的调用链：
class ClassOne:
@classmethod
def __init_subclass__(cls, **kwargs):
super().__init_subclass__(**kwargs) # ← 关键：传递控制权
print(f"ClassOne.__init_subclass__(cls = {cls})")
class ClassTwo:
@classmethod
def __init_subclass__(cls, **kwargs):
super().__init_subclass__(**kwargs) # ← 关键：传递控制权
print(f"ClassTwo.__init_subclass__(cls = {cls})")
class MyClass(ClassOne, ClassTwo):
pass # 无需额外定义 __init_subclass__运行上述代码，输出为：
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
立即学习“Python免费学习笔记（深入）”；
ClassTwo.__init_subclass__(cls = <class '__main__.MyClass'>) ClassOne.__init_subclass__(cls = <class '__main__.MyClass'>)
注意：由于 MRO 是 ClassOne → ClassTwo → object，而 super().__init_subclass__() 在 ClassOne 中调用的是 ClassTwo 的版本（即 MRO 中下一个定义该方法的类），因此 ClassTwo 先执行，ClassOne 后执行 —— 这体现了 super() 的动态绑定特性。
⚠️ 重要注意事项
- 参数一致性：所有 __init_subclass__ 方法签名应保持一致（推荐使用 **kwargs），否则 super() 调用可能因参数不匹配而报错；
- 调用时机：__init_subclass__ 在类体执行完毕、类对象创建完成后立即调用，早于任何 __new__ 或 __init__，不可用于依赖实例状态的操作；
- 避免重复副作用：若多个父类执行相似逻辑（如注册类到全局容器），需自行加锁或去重，__init_subclass__ 不提供内置防重机制；
- 不适用于 object：object 类未定义 __init_subclass__，因此链式调用最终会在 object 处自然终止，无需特殊处理。
? 总结
__init_subclass__ 的设计哲学是“显式优于隐式”。它不自动遍历所有基类，而是将控制权交由开发者通过 super() 显式编排初始化顺序。这种设计既保证了灵活性（可跳过某些父类逻辑），又避免了隐式调用带来的歧义和性能开销。掌握其 MRO 依赖与协作模式，是安全、可靠地在复杂继承体系中使用该钩子的关键。
