__init_subclass__ 适合类定义时参数校验，因其在子类定义时自动触发，早于实例化，可及时拦截非法声明；它接收类定义的关键字参数，需显式调用 super() 并抛出 TypeError 校验失败。
为什么 __init_subclass__ 适合做类定义时的参数校验
因为它是 Python 3.6+ 引入的、在子类被定义（而非实例化）时自动触发的钩子，天然适合拦截非法类声明——比如强制要求某个类必须传入 model_type 参数，或禁止某基类被直接继承而不加标记。
它比在 __new__ 或 __init__ 中校验更早，且不依赖实例创建，避免了“类已存在但无效”的尴尬状态。
常见错误现象：把校验逻辑写进 __init__，结果用户写了 class BadChild(Parent): pass，类能定义成功，但一实例化就报错——这时问题已扩散到下游使用处，不如定义时就拦住。
怎么用 __init_subclass__ 校验类参数
它接收子类定义时显式传入的关键字参数（即 class Child(Parent, some_flag=True, version="2.0"): 中的 some_flag 和 version），你可以在基类中覆写该方法并检查这些参数。
立即学习“Python免费学习笔记（深入）”；
实操要点：
-
__init_subclass__是类方法，第一个参数是cls（即将被创建的子类），后续参数是定义时传入的关键字参数 - 必须显式调用
super().__init_subclass__(**kwargs)，否则 MRO 链中断，其他父类的钩子不会执行 - 校验失败应抛出
TypeError（语义最准确），而不是ValueError或自定义异常 - 参数默认值需在钩子内部处理，不能依赖函数签名默认值（因为未传参时该 key 根本不出现在
kwargs中）
示例：
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
class ModelBase:
def __init_subclass__(cls, model_type=None, **kwargs):
super().__init_subclass__(**kwargs)
if model_type not in ("classifier", "regressor", "transformer"):
raise TypeError(f"model_type must be 'classifier', 'regressor', or 'transformer'; got {model_type!r}")
之后 class MyModel(ModelBase, model_type="clusterer"): 会在 import 时直接报错，不是运行时。
__init_subclass__ 的参数来源和兼容性陷阱
这些参数只来自类定义语句中的关键字参数，**不来自类体内的类属性、注解或装饰器**。容易误以为 @dataclass 或 __annotations__ 会被自动捕获——并不会。
使用场景限制：
- 仅适用于新式类（Python 3 默认），且基类必须显式定义该方法 不支持多重继承中同名钩子的自动合并；若多个父类都定义了
- 无法校验类名、模块路径等元信息，只能校验显式传入的键值对
- Pydantic v2 的
__pydantic_init_subclass__是其变种，但原生__init_subclass__不与 Pydantic 绑定
__init_subclass__，只有 MRO 中第一个生效，其余必须手动转发
性能影响极小：只在类对象构造时执行一次，无运行时开销。
和 __new__、metaclass 比有什么区别
三者都能干预类创建，但定位不同：__init_subclass__ 是轻量级、声明式、面向用户的校验入口；metaclass 更底层，适合改写整个类生成逻辑（如自动注册、字段重写）；__new__ 属于实例化阶段，此时类已完全构建完毕，无法阻止非法类定义。
容易踩的坑：
- 误在
__init_subclass__里修改cls.__dict__或动态加方法——虽可行，但可读性差，应优先用装饰器或元类 - 忽略
**kwargs转发，导致子类继承链断裂（例如abc.ABC的钩子失效） - 在钩子里访问尚未解析的父类属性（如
cls.__mro__[1].some_attr），可能引发AttributeError，因 MRO 已确定但部分父类属性可能还未绑定
真正关键的不是“能不能做”，而是“该不该在这里做”——如果校验逻辑涉及类型注解解析、字段遍历或 import-time 副作用，__init_subclass__ 就不是最佳位置。
