setattr 是最安全直接的实例属性添加方式，它触发 setattr 和描述符协议，但需注意目标为实例而非类，且受 slots 限制；直接操作 dict 虽快但绕过机制、风险高。
用 setattr 添加实例属性最安全直接
绝大多数时候，你只是想给某个对象临时加个字段，比如从配置读取后存为属性。setattr 是标准、可读、兼容性最好的方式，它会触发 __setattr__（如果类自定义了），也支持描述符协议。
常见错误是传错目标对象——写成 setattr(MyClass, 'x', 1) 会加到类上，而 setattr(obj, 'x', 1) 才是加到实例上。别混淆类和实例。
- 只对单个实例生效，不影响其他同类型对象
- 若类定义了
__slots__，且未在 slots 中声明该属性名，setattr会抛AttributeError - 支持动态键名：
key = 'timeout'; setattr(cfg, key, 30)
直接操作 __dict__ 快但有风险
obj.__dict__['new_attr'] = value 确实比 setattr 略快，但它绕过所有属性访问机制：不调用 __setattr__，不检查描述符，也不受 __slots__ 限制（除非对象本身没 __dict__）。
典型踩坑场景：给一个使用 __slots__ 的类实例直接写 __dict__，会报 AttributeError: 'MyClass' object has no attribute '__dict__'——因为这类对象根本没字典。
立即学习“Python免费学习笔记（深入）”；
创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。
- 仅适用于有
__dict__的普通实例（即未定义__slots__或显式保留'__dict__'） - 无法设置 property、@cached_property 等基于描述符的属性
- 调试时容易漏看，因为 IDE 和
dir()可能不立即反映这种写法
向类本身添加属性要分清“类属性”和“实例属性”
如果目标是让所有未来实例都带某个默认字段，必须操作类，而不是某个实例。但要注意：setattr(MyClass, 'default_mode', 'auto') 添加的是类属性，所有实例共享；而 setattr(obj, 'mode', 'auto') 是实例独有。
误把类属性当实例属性用，会导致状态污染。比如在 Web 请求处理器中给类加 cache = {}，结果所有请求共用一个字典。
- 类属性修改会影响所有已有和未来实例（除非实例自己覆盖了同名属性）
- 若类用了
__slots__，对类本身调用setattr仍有效（因为类对象总有__dict__） - 不推荐在运行时频繁修改类属性，尤其在多线程环境下需额外同步
需要动态数据结构？优先考虑字典或 types.SimpleNamespace
如果本质是要存一堆键值对，硬塞进实例属性反而难维护。比如解析 JSON 后想挂载为属性：data = json.loads(payload); ns = types.SimpleNamespace(**data) 比循环 setattr 更清晰。
另一个常见需求是“按需加载字段”，这时用 __getattr__ + 缓存更合适，而不是一上来就全塞进 __dict__。
-
types.SimpleNamespace支持点号访问、可变、无方法干扰，适合轻量数据载体 - 嵌套结构建议用
dataclasses或pydantic.BaseModel，而非手动setattr - 避免用
__dict__.update(dict_of_attrs)批量注入——出错时定位困难，且可能覆盖内置属性如__weakref__
