如何使用Python的vars()函数获取对象的属性字典_访问对象的__dict_

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

如何使用python的vars()函数获取对象的属性字典_访问对象的__dict__

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 或描述符。

例如：

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 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>，含类属性
</p>

再比如：

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