直接赋值最快，property有调用开销；校验优先用__post_init__或if判断；避免__init__中调用可重写方法；参数多时用typeddict约束**kwargs。
__init__ 里直接赋值 vs 使用 property 的性能差异
直接在 __init__ 中给实例赋值（如 self.name = name）是最快的方式，没有额外开销。而如果用 @property + @xxx.setter 在初始化时做校验或转换，每次赋值都会触发方法调用——哪怕只初始化一次，也多一层函数调用和栈帧开销。
常见错误：把所有字段都套上 setter 做类型检查，结果初始化耗时翻倍。真需要校验，优先用 dataclass 的 __post_init__ 或手动 if 判断，而非依赖 property。
- 简单字段（str/int/bool）：直接赋值，别绕路
- 需校验的字段（如邮箱格式、非负数）：在
__init__内用 if raise，不走 property - 需懒加载的字段（如大对象、远程数据）：延迟到第一次访问时再计算，不在
__init__初始化
避免在 __init__ 中调用可被重写的实例方法
如果 __init__ 里调用了 self.setup() 这类方法，而子类重写了它，就可能在父类尚未完全初始化完毕时执行子类逻辑——导致 AttributeError 或状态不一致。这是 Python 中典型的“过早调用”陷阱。
典型错误现象：AttributeError: 'MyClass' object has no attribute 'config'，但你在 __init__ 开头明明写了 self.config = {...}——问题出在 setup() 被提前调用，而子类 setup 依赖了还没初始化的属性。
- 把初始化逻辑全写在
__init__内部，不拆成可重写的方法 - 若必须拆分，用私有方法名（如
self._setup()），并确保子类不重写它 - 或改用类方法 + 返回实例的工厂模式，避开实例方法调用时机问题
__init__ 参数过多时，用 **kwargs + 类型注解约束更安全
当参数超过 5 个，硬写 def __init__(self, a, b, c, d, e, f) 不仅难维护，还容易错位传参。用 **kwargs 接收再校验，配合 typing.TypedDict 或 dataclass，能兼顾灵活性与类型安全。
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
注意：纯 **kwargs 会丢失 IDE 提示和 mypy 检查；不加约束等于放弃静态分析优势。
- 推荐方案：定义
InitOptions = TypedDict('InitOptions', {'host': str, 'port': int})，然后def __init__(self, **kwargs: Unpack[InitOptions]) - 避免：直接
def __init__(self, **kwargs)然后靠运行时 if 判断字段是否存在 - 兼容旧版本 Python（dataclass 定义配置类，
__init__只接收一个该类实例
__init__ 中初始化可变默认参数的坑
写成 def __init__(self, items=[]) 是经典陷阱：这个 [] 是模块加载时创建的单个 list 对象，所有实例共享。后续任意实例对 self.items.append(x) 都会污染其他实例。
错误现象：多个对象的 items 列表内容意外同步增长。
- 正确写法：
def __init__(self, items=None): self.items = items if items is not None else [] - 更简洁（Python 3.8+）：
def __init__(self, items: Optional[List[str]] = None): self.items = items or []，但注意items=[]仍不可用 - 字典同理：
def __init__(self, meta=None): self.meta = meta if meta is not None else {}
这个坑小但杀伤力强，一旦发生很难复现——因为只有在多次实例化且都未传参时才暴露。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
