通过 __init_subclass__ 钩子，可在继承时直接传递参数（如 exclude=、custom=），完全避免显式声明 metaclass=，既保持语法简洁性，又规避了多层元类冲突风险。
通过 `__init_subclass__` 钩子，可在继承时直接传递参数（如 `exclude=`、`custom=`），完全避免显式声明 `metaclass=`，既保持语法简洁性，又规避了多层元类冲突风险。
在 Python 中，若希望用户定义子类时能以类似 class Serial(SerialBase, exclude=["value"], custom=["terminals"]): 的方式传入配置参数（而非冗长的 metaclass=MetaSerial, exclude=..., custom=...），最推荐、最 Pythonic 的方案是使用 __init_subclass__ —— 它是 Python 3.6+ 引入的内置机制，专为在子类创建时执行自定义逻辑而设计。
__init_subclass__ 会在每次定义继承自该基类的新类时自动调用，并接收所有在类定义中显式写出的关键字参数（即 exclude=、custom= 等），无需元类介入。这不仅语义清晰、易于理解，还天然兼容多重继承，彻底规避元类冲突问题（例如当其他库也使用自定义元类时）。
以下是一个完整、可运行的示例：
class SerialBase:
def __init_subclass__(cls, exclude=None, custom=None, **kwargs):
super().__init_subclass__(**kwargs)
# 提供默认空列表，避免可变默认参数陷阱
cls._exclude = exclude or []
cls._custom = custom or []
# ✅ 语法简洁，与 TypedDict 风格一致
class Serial(SerialBase, exclude=["value"], custom=["terminals"]):
pass
# 验证效果
print(Serial._exclude) # ['value']
print(Serial._custom) # ['terminals']⚠️ 注意事项：
- __init_subclass__ 接收的是类定义时的关键字参数，仅作用于子类本身（即 Serial 类对象），不涉及实例初始化；
- 必须显式调用 super().__init_subclass__(**kwargs)，以确保父类链（如 object）的正确初始化；
- 参数默认值建议使用 None 而非 [] 或 {}，防止可变默认参数引发意外共享；
- 若需对类体中的属性或方法做进一步处理（如字段校验、装饰器注入等），仍可在 __init_subclass__ 中操作 cls.__dict__ 或使用 inspect 模块分析。
总结：除非你必须在类对象创建前（即 type.__new__ 阶段）干预类结构（如动态生成属性、重写 __annotations__、强制接口实现等），否则 __init_subclass__ 是替代元类参数化设计的首选方案——它更轻量、更安全、更易维护，且语法上真正实现了你所期望的“像 TypedDict 一样自然”的声明风格。
