vars()返回对象的__dict__,仅对具有实例字典的对象有效(如普通自定义类实例、模块、函数),内置类型和使用__slots__的类会抛出typeerror;它只返回当前实例的可变属性,而dir()返回所有可访问属性名。

vars() 返回的是对象的 __dict__,但不是所有对象都有
直接调用 vars(obj) 等价于访问 obj.__dict__,但它会先检查对象是否实现了 __dict__ 属性。内置类型(如 list、str、int)和使用 __slots__ 的类通常没有 __dict__,此时 vars() 会抛出 TypeError: vars() argument must have __dict__ attribute。
- 只对「有实例字典」的对象有效:普通自定义类实例、模块、函数等
- 模块对象可用:
vars(sys)能看到导入的模块内容 - 函数对象也可用:
vars(len)会显示其__doc__、__name__等属性 - 别对
json.loads("{"a":1}")这种 dict 实例用 ——dict没有__dict__
vars() 和 dir() 的关键区别在哪
dir() 返回的是「可访问的属性名列表」,包括继承的、特殊方法、类属性;而 vars() 只返回当前对象实例的可变属性字典(即 __dict__ 中的键值对),不包含方法、类变量或父类属性。
-
dir(obj)可能返回上百个名字,vars(obj)通常只返回你显式赋值过的实例属性 -
vars()返回的是dict,可直接遍历或修改;dir()返回的是list,只读 - 想看「这个对象此刻存了哪些数据字段」,优先用
vars();想查「它能响应哪些属性/方法」,用dir()
常见误用:试图用 vars() 查看类本身或命名空间
vars(MyClass) 是合法的(返回类对象的 __dict__),但容易混淆——它展示的是类定义时的属性(如方法、类变量),不是某个实例的状态。更危险的是传入局部作用域,比如在函数里写 vars() 不带参数,它会返回当前局部命名空间(类似 locals()),但这不是“查看对象”的本意,且在优化模式(-O)下可能失效。
- 不带参数的
vars()等价于locals(),仅限调试,别用于生产逻辑 - 类对象的
vars()包含__init__、__module__等,但不含实例属性 —— 别把它和实例的vars()混为一谈 - 如果想安全地“尝试查看任意对象”,加一层异常捕获:
try:<br> print(vars(obj))<br>except TypeError:<br> print(f"{obj!r} has no __dict__")
替代方案:当 vars() 失效时怎么查属性
遇到 TypeError 或需要更完整视图时,不能硬刚 vars()。用 getattr() 配合 dir() 是更鲁棒的做法,尤其适合 inspect 类型对象或调试第三方库。
- 获取所有非私有、非特殊属性的值:
{k: getattr(obj, k) for k in dir(obj) if not k.startswith('_')} - 想包含私有属性但排除双下划线方法:
{k: getattr(obj, k) for k in dir(obj) if not k.endswith('__') and not k.startswith('__')} - 对 dataclass 或 Pydantic 模型,优先用
obj.__dict__或专用方法(如model_dump()),它们比通用vars()更可靠
vars(),而是意识到它背后依赖的是 Python 对象模型中那个隐式的 __dict__ —— 一旦对象被冻结、用了 __slots__、或是 C 扩展实现,这个门就关上了。Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











