Python 中可通过 __init_subclass__ 钩子替代自定义元类，实现类似 TypedDict 的简洁语法——在类继承列表中直接传入参数（如 exclude=、custom=），无需 metaclass= 关键字，既安全又易维护。
python 中可通过 `__init_subclass__` 钩子替代自定义元类，实现类似 `typeddict` 的简洁语法——在类继承列表中直接传入参数（如 `exclude=`、`custom=`），无需 `metaclass=` 关键字，既安全又易维护。
在 Python 类设计中，若希望子类能以声明式方式接收配置参数（例如 exclude=["value"]），许多人第一反应是编写自定义元类。但元类存在固有缺陷：它强制占据类的 metaclass 位置，极易与其他依赖元类的库（如 attrs、Pydantic v1、ORM 框架）发生冲突，且语法冗长、可读性差。
更现代、更推荐的替代方案是使用 __init_subclass__ ——这是 Python 3.6+ 引入的类创建钩子，专为“在子类定义时执行初始化逻辑”而设计，语义清晰、兼容性强，且天然支持关键字参数传递。
以下是一个完整示例：
class SerialBase:
def __init_subclass__(cls, exclude=None, custom=None, **kwargs):
super().__init_subclass__(**kwargs)
# 提供默认空列表，避免可变默认参数陷阱
cls._exclude = exclude or []
cls._custom = custom or []
# ✅ 简洁声明：参数直接写在基类后，无需 metaclass=
class Serial(SerialBase, exclude=["value"], custom=["terminals"]):
pass
# 验证结果
print(Serial._exclude) # ['value']
print(Serial._custom) # ['terminals']⚠️ 注意事项：
- __init_subclass__ 接收的 **kwargs 必须转发给 super().__init_subclass__(**kwargs)，否则可能破坏多重继承链（尤其当其他父类也定义该方法时）；
- 参数默认值建议用 None 而非 [] 或 {}，防止意外的跨类共享可变对象；
- 该机制仅在直接继承时生效；若通过中间类间接继承，需确保中间类正确调用 super().__init_subclass__()；
- __init_subclass__ 在类对象创建后、模块执行完成前触发，适合设置类属性、注册类型或验证结构，但不适用于修改类体字典（如动态注入方法）——此类需求仍需元类或装饰器。
总结：除非必须在类构建早期（__new__ 阶段）深度干预类结构（如重写 __annotations__、生成 __slots__、强制接口实现），否则优先选用 __init_subclass__。它语法优雅、无冲突风险、符合 Python 的显式与实用哲学，是替代轻量级元类的首选方案。
