Python中使用vars()获取对象属性字典的方法

本文深入解析了Python中`vars()`函数的本质与局限：它并非万能的属性提取工具，而是`obj.__dict__`的安全封装，仅适用于拥有`__dict__`属性的对象（如普通自定义类实例）；面对`__slots__`类、内置类型、`namedtuple`、`frozen dataclass`等无`__dict__`的对象时会直接抛出`TypeError`。文章厘清了`vars()`与`__dict__`的异同，指出在调试、序列化或动态属性验证等场景下直接操作`__dict__`更高效可控，并揭露了常见误区——`vars()`不包含类属性、`@property`、描述符、`__weakref__`等，也不递归或合并继承链。最后提供了健壮的`safe_attrs()`方案，通过分层判断`__dict__`、`__slots__`和`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__，但逻辑上不是“实例属性”）。

典型场景：

• 写一个通用对象序列化函数，需跳过方法、下划线前缀属性、描述符等 → 直接操作 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 或描述符。

例如：

class A:
    x = 1
    def __init__(self):
        self.y = 2
a = A()
print(vars(a))        # {'y': 2} —— 只有实例属性，类属性 x 不在其中
print(a.dict)     # 同上
print(vars(A))        # {'module': 'main', 'x': 1, ...} —— 类的 dict，含类属性

再比如：

• 有 @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() 返回的是它的引用，不是副本——这点在做深拷贝或审计时特别关键。

理论要掌握，实操不能落！以上关于《Python中使用vars()获取对象属性字典的方法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！