vars()本质是obj.__dict__的安全封装,仅对拥有__dict__的对象有效;无__dict__时(如__slots__类、内置类型)会抛TypeError,此时应改用hasattr检查或dir()+getattr组合获取属性。

vars() 和 __dict__ 本质一样,但调用条件不同
直接说结论:vars(obj) 其实就是 obj.__dict__ 的安全封装——它只对拥有 __dict__ 的对象有效,否则抛 TypeError。不是所有对象都有 __dict__,比如内置类型(list、int)、使用 __slots__ 的类实例、或者 C 扩展对象(如 numpy.ndarray)通常没有。
所以别默认 vars(obj) 总能用,先确认对象是否支持属性动态绑定:
- 普通自定义类(没定义
__slots__)→ ✅ 可用 - 继承自
object且显式声明了__slots__ = [...]→ ❌vars()报错,只能查__slots__列表里的字段(但值不存于__dict__) -
namedtuple、dataclass(frozen=True)、enum.Enum→ ❌ 多数无__dict__,vars()失败
什么时候必须用 __dict__ 而不能依赖 vars()
当你已经确定对象有 __dict__,但想绕过 vars() 的类型检查时,直接访问更高效也更明确。尤其在调试或元编程中,你可能需要区分“真·属性字典”和“vars() 包装后可能返回的其他映射”(比如模块对象的 vars() 返回的是其全局命名空间,本质是 module.__dict__,但逻辑上不是“实例属性”)。
典型场景:
立即学习“Python免费学习笔记(深入)”;
- 写一个通用对象序列化函数,需跳过方法、下划线前缀属性、描述符等 → 直接操作
obj.__dict__.items()更可控 - 给实例动态加属性后立刻检查是否生效 →
obj.__dict__.keys()比vars(obj).keys()少一层间接调用 - 遇到
TypeError: vars() argument must have __dict__ attribute错误时,说明该对象不支持,此时不能硬用vars(),而应换策略(如用dir()+getattr()过滤)
常见错误:把 vars() 当成万能属性提取器
很多人看到文档里写“vars([object]) returns the __dict__ attribute”,就以为它能“取出任意对象的所有属性”。这是误解。它只返回那个特定的 __dict__ 映射,不递归、不合并父类属性、不处理 property 或描述符。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
例如:
class A:
x = 1
def __init__(self):
self.y = 2
<p>a = A()
print(vars(a)) # {'y': 2} —— 只有实例属性,类属性 x 不在其中
print(a.<strong>dict</strong>) # 同上
print(vars(A)) # {'<strong>module</strong>': '<strong>main</strong>', 'x': 1, ...} —— 类的 <strong>dict</strong>,含类属性
再比如:
- 有
@property的字段不会出现在vars()或__dict__中 -
__weakref__默认也不在vars()输出里(除非手动加进去) - 使用
__slots__后,__dict__根本不存在,vars()必然失败
安全获取属性键值对的推荐做法
如果你的目标是“尽可能多地拿到对象当前可读取的属性名和值”,不要只押注 vars() 或 __dict__。更健壮的做法是组合判断:
- 先尝试
getattr(obj, '__dict__', None),不抛错就用它 - 如果为
None,再检查hasattr(obj, '__slots__'),有则遍历__slots__用getattr()提取 - 最后 fallback 到
[name for name in dir(obj) if not name.startswith('_')]+getattr(),但注意这会包含方法、类属性、继承来的属性,需按需过滤
简单脚本示例(仅处理常见情况):
def safe_attrs(obj):
if hasattr(obj, '__dict__'):
return dict(obj.__dict__)
elif hasattr(obj, '__slots__'):
return {k: getattr(obj, k) for k in obj.__slots__ if hasattr(obj, k)}
else:
return {}
这个函数比裸调 vars() 少报错,也比盲目用 dir() 更精准。
真正容易被忽略的是:__dict__ 是可写的,修改它会直接影响实例状态;而 vars() 返回的是它的引用,不是副本——这点在做深拷贝或审计时特别关键。

















