__getattr__ 仅在访问不存在属性时触发,用于动态代理、惰性加载和友好错误提示;它不拦截已定义属性或方法,也不替代 __getattribute__。

__getattr__ 是 Python 中一个常被误解但非常实用的魔法方法,它只在访问对象**不存在的属性时**被自动调用,用于提供“兜底逻辑”,而不是每次属性访问都触发。
动态代理与属性转发
当你想把某个对象包装一层,又不想手动定义所有属性和方法时,可以用 __getattr__ 把未知访问自动转给内部对象。比如封装一个配置类,底层是字典,但希望像访问属性一样读取键值:
class Config:
def __init__(self, data):
self._data = data
def __getattr__(self, name):
if name in self._data:
return self._data[name]
raise AttributeError(f"'{type(self).__name__}' object has no attribute '{name}'")
这样 cfg.host 就等价于 cfg._data['host'],无需提前声明每个字段。
惰性加载与按需计算
某些属性开销大(如网络请求、文件读取、复杂计算),你不希望它们在实例创建时就执行,而是在第一次访问时才生成并缓存。这时 __getattr__ 可配合 __dict__ 实现懒初始化:
立即学习“Python免费学习笔记(深入)”;
class ExpensiveResource:
def __init__(self):
self._cache = {}
def __getattr__(self, name):
if name == 'data':
self._cache[name] = self._load_data() # 耗时操作
return self._cache[name]
raise AttributeError(name)
统一错误处理与调试友好提示
默认的 AttributeError 提示比较生硬。通过 __getattr__ 可以拦截缺失属性,给出更清晰的建议或上下文信息:
- 检查拼写相近的属性名,提示可能的正确写法
- 列出当前可用的属性(如从 dir(self) 过滤出公共属性)
- 记录日志,帮助定位误用位置
注意:不是所有属性访问都会触发它
__getattr__ 仅在常规查找失败后调用,即:
- 不拦截已定义的实例属性、类属性、描述符、方法
- 不替代 __getattribute__(后者更底层,每次访问都走,容易引发无限递归)
- 如果同时定义了 __getattribute__,必须显式抛出 AttributeError 才会进入 __getattr__










