__init_subclass__ 不能直接接收位置参数，但可通过 **kwargs 间接获取类定义时传入的关键字参数（如 class child(parent, flag=true):），需手动校验并赋值给类属性，是声明期注入元信息的最简方式。
__init_subclass__ 能不能接收自定义参数
不能直接接收，但可以间接实现。Python 的 __init_subclass__ 本身只接受 **kwargs，不支持位置参数或强制参数签名；它被调用时，会自动接收类定义时在括号中传给父类的任意关键字参数（即 class Child(Parent, some_flag=True, version="1.2"): 中的 some_flag 和 version）。
常见错误是写成这样：
class Parent:
def __init_subclass__(cls, name, **kwargs):
super().__init_subclass__(**kwargs) # ❌ TypeError: __init_subclass__() takes 2 positional arguments but 3 were given
原因：子类定义时传参是关键字形式，而 __init_subclass__ 方法签名里写了位置参数 name，但实际调用时 Python 不会把 name=... 映射过去——它只按关键字名匹配。
- 必须用
**kwargs捕获所有传入参数 - 参数名需与类定义时写的 key 完全一致（区分大小写）
- 如果想校验必填参数，得手动从
kwargs里 pop 或 get，并抛异常
给类加元数据的典型写法
用 __init_subclass__ 把参数存到类属性上，是最轻量、最 Pythonic 的方式。适用于标记用途、路由注册、序列化配置等场景。
例如为 API 视图类添加版本和权限标签：
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
class View:
def __init_subclass__(cls, version=None, permission=None, **kwargs):
super().__init_subclass__(**kwargs)
cls._meta_version = version
cls._meta_permission = permission
<p>class UserListView(View, version="v2", permission="read:user"):
pass</p><p>print(UserListView._meta_version) # "v2"
print(UserListView._meta_permission) # "read:user"
</p>
- 参数必须出现在继承列表中，且在父类名之后（
View, version="v2"），不能写在类体里 - 未传的参数值为
None，不是缺失；要用kwargs.get("version")判断是否显式传入 - 避免覆盖已有类属性名（如不小心用了
name，可能和cls.__name__冲突）
和 __set_name__、class decorator 对比有什么区别
__init_subclass__ 是声明期行为，在类对象创建完成、但尚未执行类体代码前触发；而 __set_name__ 是描述符协议，仅对字段生效；class decorator 是包装器，发生在类已构建完毕之后。
-
__init_subclass__：适合“所有子类统一注入元信息”，不可跳过，无法控制执行顺序 -
__set_name__：只对带__set_name__方法的描述符实例起作用，和类参数无关 - class decorator：灵活，可条件应用，但需要显式装饰，且无法访问类定义时的括号参数
如果你希望某个基类的所有子类都自动带 schema_type 字段，__init_subclass__ 是唯一能原生支持该语法的机制。
容易忽略的兼容性与调试点
Python 3.6+ 才支持 __init_subclass__，且它的调用时机比 __new__ 和 __init__ 更早——此时类的 __dict__ 还没完全构建好，某些动态属性可能还不可见。
- 不要在
__init_subclass__里调用子类的类方法或访问尚未定义的类变量 - 多重继承时，只有第一个父类的
__init_subclass__会被调用（除非显式链式调用super()） - 调试时可在方法开头加
print(f"Init subclass: {cls.__name__}, kwargs={kwargs}")，确认参数是否如期传入 - 若配合 typing、dataclass 或 pydantic 使用，注意它们可能重写
__init_subclass__，需小心协作或改用__post_init_subclass__（pydantic v2 提供）
真正麻烦的不是怎么写，而是当多个框架都试图接管 __init_subclass__ 时，谁先谁后、要不要 super()、漏掉会不会静默失败——这些细节不打日志根本看不出问题。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
