Python多类继承下__init_subclass__为何仅调用一次？

在研究多继承场景中使用__init_subclass__时，遇到一个问题：Python官方Bug报告#42674提到该方法在多继承时仅被调用一次而非两次，官方回复指出是因为子类未调用super()。但修改代码尝试触发两个__init_subclass__方法后，仍仅输出ClassOne的调用结果，使用Python 3.7版本。

官方报告附带代码 #

class ClassOne:
    @classmethod
    def __init_subclass__(cls):
        print(f"ClassOne.__init_subclass__( cls = {cls} )")

class ClassTwo:
    @classmethod
    def __init_subclass__(cls):
        print(f"ClassTwo.__init_subclass__( cls = {cls} )")


class MyClass(ClassOne, ClassTwo):
    def __init__(self):
        super().__init__()
        super(ClassOne, self).__init__()

我的尝试代码 #

class ClassOne:
    @classmethod
    def __init_subclass__(cls):
        print(f"ClassOne.__init_subclass__( cls = {cls} )")

    def __init__(self):
        super().__init__()
        print(f"ClassOne.__init__( self = {self} )")

class ClassTwo:
    @classmethod
    def __init_subclass__(cls):
        print(f"ClassTwo.__init_subclass__( cls = {cls} )")

    def __init__(self):
        super().__init__()
        print(f"ClassTwo.__init__( self = {self} )")

class MyClass(ClassOne, ClassTwo):
    def __init__(self):
        super(ClassOne, self).__init__()
        super(ClassTwo, self).__init__()

运行结果 #

> python3 init_subclass.py
ClassOne.__init_subclass__( cls = <class '__main__.MyClass'> )

问题原因与解决方法 #

__init_subclass__是在子类定义阶段自动触发的方法，和实例化时调用的__init__逻辑完全不同。官方所说的“子类未调用super()”，实际是指父类的__init_subclass__方法内部需要主动调用super().__init_subclass__()，这样才能沿着MRO（方法解析顺序）触发下一个父类的__init_subclass__。

修改后的正确代码：

class ClassOne:
    @classmethod
    def __init_subclass__(cls):
        print(f"ClassOne.__init_subclass__( cls = {cls} )")
        # 调用super，触发MRO链中的下一个__init_subclass__
        super().__init_subclass__()

class ClassTwo:
    @classmethod
    def __init_subclass__(cls):
        print(f"ClassTwo.__init_subclass__( cls = {cls} )")
        # 同样调用super，确保后续还有父类时能继续触发
        super().__init_subclass__()

class MyClass(ClassOne, ClassTwo):
    def __init__(self):
        super().__init__()

此时运行结果会同时输出两个父类的__init_subclass__调用：

ClassOne.__init_subclass__( cls = <class '__main__.MyClass'> )
ClassTwo.__init_subclass__( cls = <class '__main__.MyClass'> )

原理：当定义MyClass时，Python会自动调用ClassOne.__init_subclass__(MyClass)，由于ClassOne的__init_subclass__里调用了super().__init_subclass__()，而MyClass的MRO中ClassOne之后是ClassTwo，所以会接着调用ClassTwo.__init_subclass__(MyClass)。

内容的提问来源于stack exchange，提问作者kdubs