vars()不传参时等价于locals()，传参后返回对象的__dict__；locals()只返回当前作用域局部变量快照且不可修改，vars()则依赖对象是否支持__dict__。
vars() 不传参时等价于 locals()，但传参后行为完全不同
很多人以为 vars() 就是 locals() 的别名，其实只在不传参数时成立。一旦传入对象（比如类实例、模块），vars() 会返回该对象的 __dict__；而 locals() 始终只返回当前作用域的局部变量快照，不接受参数。
常见错误现象：vars(my_obj) 报 TypeError: vars() argument must have __dict__ attribute —— 这说明对象没定义 __dict__（比如用了 __slots__ 或是内置类型）。
-
vars()本质是obj.__dict__的安全封装，仅对支持属性动态绑定的对象有效 -
locals()是纯运行时快照，返回的是 dict 类型，但修改它不影响实际变量（CPython 中甚至可能被优化掉） - 在函数内部调用
locals()可能因编译器优化返回空字典（尤其有闭包或使用了exec）
locals() 修改字典内容不会影响真实变量值
这是最常被误解的一点：拿到 locals() 返回的字典后去改键值，比如 locals()['x'] = 42，对后续代码完全无效。
使用场景极少，主要出现在调试辅助或元编程中尝试“动态读取”局部变量，但绝不能用于“动态写入”。Python 规范明确不保证 locals() 返回的字典与实际局部命名空间同步。
立即学习“Python免费学习笔记（深入）”；
- CPython 在无自由变量且未调用
exec时，可能直接返回空字典或只读副本 - 即使返回了完整字典，赋值操作也只修改字典本身，不触发变量重绑定
- 若真需要动态绑定变量，应改用
exec()（不推荐）或重构为字典驱动逻辑
vars() 对内置类型或 frozen dataclass 失效
不是所有 Python 对象都能用 vars() 查看属性。内置类型（如 list、str）、@dataclass(frozen=True)、启用了 __slots__ 的类，通常没有 __dict__，调用 vars(obj) 就会失败。
这时候得换方法：用 dir(obj) 看可用属性名，再配合 getattr(obj, attr, None) 逐个提取；或者检查 hasattr(obj, '__dict__') 再决定是否调用 vars()。
-
vars([])→TypeError；vars(type('A', (), {})())→ 正常返回空__dict__ - 带
__slots__的类实例，vars()失败，但obj.__slots__列出了可访问字段 - dataclass 默认有
__dict__，但加了frozen=True后仍保留，只是不可写 ——vars()仍可用
调试时优先用 vars(self) 而非 locals() 查实例状态
在类方法里想快速查看当前实例的所有属性，vars(self) 比 locals() 更可靠、更语义清晰。locals() 会混入形参、临时变量甚至推导式变量，噪音大；vars(self) 只聚焦对象自身的数据属性。
性能上几乎无差别，但可读性和意图表达强得多。尤其在复杂方法或继承链深的类中，vars(self) 直接排除了作用域污染干扰。
- 注意：如果类重写了
__getattribute__或用了属性描述符，vars(self)仍只显示__dict__里的键，不包括动态计算属性 - 想连同 property 一起看？得手动遍历
dir(self)并过滤出非私有、非方法的名称 - IPython/Jupyter 中直接输入
self或调用self.__dict__更快，vars(self)主要用于脚本内一致性输出
