Python中vars()与locals()的区别解析

Python中vars()和locals()虽常被混淆，但本质截然不同：vars()不传参时确实等价于locals()，可一旦传入对象便转为安全访问其__dict__属性的工具，而locals()仅返回当前作用域局部变量的只读快照，修改它毫无效果，甚至在CPython优化下可能为空；二者真正关键的区别在于——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() 返回的字典与实际局部命名空间同步。

• 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) 主要用于脚本内一致性输出

事情说清了就结束。真正容易被忽略的是：locals() 的返回值不是活引用，vars() 的可用性取决于对象是否有 __dict__——这两点在动态反射和调试时，比语法差异影响更大。

好了，本文到此结束，带大家了解了《Python中vars()与locals()的区别解析》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！