动态添加__init_subclass__方法时参数绑定异常问题咨询

这个问题的核心在于Python对__init_subclass__的特殊处理逻辑，咱们一步步拆解原因和解决方案：

静态定义 vs 动态赋值的核心差异 #

当你静态在类中写__init_subclass__时，Python会自动把它当作隐式类方法处理——不需要手动加@classmethod装饰器，Python会在子类创建时自动把第一个参数（通常命名为subcls）绑定到新创建的子类对象。

但如果你通过装饰器动态给类赋值一个普通函数作为__init_subclass__，这个自动绑定逻辑不会触发。因为Python只在类定义的扫描阶段（也就是执行class代码块的时候）会识别并处理__init_subclass__的隐式类方法特性，动态赋值时这个阶段已经结束了，普通函数不会被自动转换为类方法，导致第一个参数无法被自动传入。

错误示例（复现你的问题） #

def add_init_subclass(cls):
    # 这里定义的是普通函数，不是类方法
    def __init_subclass__(subcls, *args, **kwargs):
        super().__init_subclass__(*args, **kwargs)
        print(f"init_subclass ... {subcls.__name__}")
    # 直接赋值普通函数，Python不会自动处理为类方法
    cls.__init_subclass__ = __init_subclass__
    return cls

@add_init_subclass
class C1:
    pass

# 创建子类时会报错：__init_subclass__() missing 1 required positional argument: 'subcls'
class C2(C1):
    pass

正确的解决方案 #

有两种方式可以让动态添加的__init_subclass__正常绑定子类参数：

方式1：用@classmethod装饰动态方法 #

直接给动态定义的__init_subclass__加上@classmethod装饰器，显式把它转换成类方法：

def add_init_subclass(cls):
    @classmethod
    def __init_subclass__(subcls, *args, **kwargs):
        # 这里的subcls会被自动绑定到新创建的子类
        super().__init_subclass__(*args, **kwargs)
        print(f"init_subclass ... {subcls.__name__}")
    cls.__init_subclass__ = __init_subclass__
    return cls

@add_init_subclass
class C1:
    pass

class C2(C1):
    # 正常输出：init_subclass ... C2
    pass

方式2：手动创建classmethod对象 #

如果你不想用装饰器语法，也可以直接把普通函数包装成classmethod对象再赋值：

def add_init_subclass(cls):
    def __init_subclass__(subcls, *args, **kwargs):
        super().__init_subclass__(*args, **kwargs)
        print(f"init_subclass ... {subcls.__name__}")
    # 手动将函数转换为类方法
    cls.__init_subclass__ = classmethod(__init_subclass__)
    return cls

补充说明 #

调用super().__init_subclass__(*args, **kwargs)是必要的——它会触发父类（比如最顶层的object类）的__init_subclass__逻辑，避免破坏Python的继承链行为，这和你静态定义的代码逻辑完全一致。

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