news 2026/5/23 16:46:01

《深入 Python 对象协议：getattr、getattribute、setattr 调用顺序与避免无限递归的实战指南》

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
《深入 Python 对象协议：getattr、getattribute、setattr 调用顺序与避免无限递归的实战指南》

《深入 Python 对象协议：getattr、getattribute、setattr 调用顺序与避免无限递归的实战指南》

在我教授 Python 的这些年里，关于对象属性访问机制的问题，几乎每一届学生都会问到：
“老师，getattr 和 getattribute 到底谁先调用？”
“为什么我重写了__getattribute__就无限递归了？”
“setattr 是什么时候触发的？能不能拦截所有属性赋值？”

这些问题看似细节，却深刻影响着我们对 Python 对象模型的理解。掌握它们，你会发现 Python 的动态性远比你想象得更强大，也更优雅。

今天这篇文章，我希望带你从基础到进阶，完整理解 Python 属性访问背后的机制，并通过大量代码示例与实战案例，帮助你真正掌握如何安全、优雅地使用这些魔法方法。

一、开篇：为什么要理解 getattr / getattribute / setattr？

Python 之所以被称为“胶水语言”，很大程度上源于它的动态对象模型。
你可以在运行时：

  • 动态添加属性
  • 拦截属性访问
  • 修改对象行为
  • 实现代理模式、ORM、序列化框架、依赖注入等高级功能

这些能力的核心基础，就是 Python 的属性访问协议（Attribute Access Protocol）。

理解__getattr__、__getattribute__、__setattr__的调用顺序，是掌握 Python 元编程的第一步。

二、基础知识：三个魔法方法的职责

1.__getattribute__(self, name)

  • 所有属性访问都会首先调用它
  • 无条件触发
  • 即便属性不存在也会调用

它是 Python 属性访问链的入口。

2.__getattr__(self, name)

  • 仅当属性不存在时才调用
  • 是兜底方案（fallback）

常用于：

  • 提供默认值
  • 动态生成属性
  • 实现代理模式

3.__setattr__(self, name, value)

  • 所有属性赋值都会调用
  • 包括self.x = 1、setattr(obj, 'x', 1)

常用于：

  • 属性校验
  • 数据绑定
  • ORM 字段管理

三、核心问题：三者的调用顺序是什么？

这是本文的核心之一。

属性访问顺序（读取）

当你执行：

obj.x

Python 的调用顺序是：

1. __getattribute__(self, 'x') ↓ 2. 如果 __getattribute__ 抛出 AttributeError： 调用 __getattr__(self, 'x')

也就是说：

  • __getattribute__永远先调用
  • __getattr__只有在属性不存在时才调用

属性赋值顺序（写入）

当你执行：

obj.x=10

Python 会：

1. 调用 __setattr__(self, 'x', 10)

没有 fallback，也不会调用__getattribute__。

四、为什么会出现无限递归？

看下面这个例子：

classA:def__getattribute__(self,name):print("getattribute:",name)returnself.__dict__[name]a=A()a.x=1print(a.x)

运行后你会看到：

RecursionError: maximum recursion depth exceeded

为什么？

因为：

self.__dict__

本身也是一个属性访问，会再次触发__getattribute__，于是无限递归。

五、如何避免无限递归？（关键技巧）

1. 使用object.__getattribute__访问原始实现

正确写法：

classA:def__getattribute__(self,name):print("getattribute:",name)returnobject.__getattribute__(self,name)

这是最常见、最安全的方式。

2. 在__setattr__中避免递归

错误写法：

def__setattr__(self,name,value):self.name=value# 递归！

正确写法：

def__setattr__(self,name,value):object.__setattr__(self,name,value)

3. 在__getattr__中返回默认值时也要避免递归

错误写法：

def__getattr__(self,name):returnself.default# default 不存在又触发 __getattr__

正确写法：

def__getattr__(self,name):returnobject.__getattribute__(self,'default')

六、完整示例：安全拦截属性访问

下面是一个安全、可扩展的属性拦截器：

classAttrLogger:def__getattribute__(self,name):print(f"[GET]{name}")returnobject.__getattribute__(self,name)def__getattr__(self,name):print(f"[GETATTR fallback]{name}")returnf"<Missing attribute:{name}>"def__setattr__(self,name,value):print(f"[SET]{name}={value}")object.__setattr__(self,name,value)

测试：

a=AttrLogger()a.x=10print(a.x)print(a.y)

输出：

[SET] x = 10 [GET] x 10 [GET] y [GETATTR fallback] y <Missing attribute: y>

七、进阶：利用属性拦截实现动态代理（Proxy）

属性拦截最常见的应用之一，就是实现代理模式。

例如，我们想创建一个对象，它能把所有属性访问转发给另一个对象：

classProxy:def__init__(self,target):object.__setattr__(self,'_target',target)def__getattribute__(self,name):target=object.__getattribute__(self,'_target')print(f"Proxy GET{name}")returngetattr(target,name)def__setattr__(self,name,value):target=object.__getattribute__(self,'_target')print(f"Proxy SET{name}={value}")setattr(target,name,value)

测试：

classUser:def__init__(self):self.name="Alice"u=User()p=Proxy(u)print(p.name)p.name="Bob"print(u.name)

输出：

Proxy GET name Alice Proxy SET name = Bob Bob

这就是 ORM、RPC 框架常用的设计方式。

八、实战案例：用 getattr / setattr 实现轻量级 ORM 字段管理

下面是一个简化版 ORM 模型：

classField:def__init__(self,default=None):self.default=defaultclassModel:def__init__(self):object.__setattr__(self,'_data',{})def__getattribute__(self,name):fields=object.__getattribute__(self,'_data')ifnameinfields:returnfields[name]returnobject.__getattribute__(self,name)def__setattr__(self,name,value):fields=object.__getattribute__(self,'_data')fields[name]=value

使用：

classUser(Model):name=Field(default="Unknown")age=Field(default=0)u=User()u.name="Alice"print(u.name)

你会发现：

  • 所有字段都被存储在_data中
  • 属性访问被拦截并重定向

这是 Django ORM、SQLAlchemy 的核心思想之一。

九、最佳实践：如何优雅地使用属性拦截？

1. 永远使用object.__getattribute__/object.__setattr__

避免递归的唯一正确方式。

2. 不要滥用属性拦截

它会：

  • 降低可读性
  • 增加调试难度
  • 影响性能

3. 用于明确的场景

例如：

  • 动态代理
  • ORM 字段管理
  • 数据绑定
  • 延迟加载（lazy loading）
  • 访问控制（只读属性）

4. 避免在__getattribute__中做复杂逻辑

因为它会拦截所有属性访问，包括内部方法。

十、前沿视角：属性拦截在现代 Python 中的应用

1. FastAPI / Pydantic

大量使用属性拦截实现：

  • 字段校验
  • 动态生成模型
  • 自动序列化

2. SQLAlchemy

利用属性拦截实现：

  • 延迟加载
  • 字段代理
  • 动态查询构建

3. AI 框架（如 PyTorch）

通过属性拦截实现：

  • 模型参数管理
  • 自动梯度跟踪

属性拦截是现代 Python 框架的核心能力之一。

十一、总结

本文我们从基础到进阶，完整讲解了：

  • __getattribute__、__getattr__、__setattr__的职责与调用顺序
  • 为什么会出现无限递归
  • 如何正确避免递归
  • 如何利用属性拦截实现代理、ORM 等高级功能
  • 最佳实践与前沿应用

如果你能真正理解这些内容，你已经迈入 Python 元编程的大门。

十二、互动讨论

我很想听听你的经验：

  • 你在使用__getattribute__时遇到过哪些坑？
  • 你是否尝试过用属性拦截实现某种框架或工具？
  • 你觉得 Python 的对象模型未来还会有哪些演进？

欢迎在评论区分享你的故事，我们一起交流、一起成长。

如果你愿意，我还可以继续为你写：

  • 更深入的元类（metaclass）教程
  • Python 对象模型全景图
  • 代理模式、ORM 框架的完整实现

告诉我你的方向，我会陪你继续探索 Python 的世界。

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/5/22 2:20:04

Windows多显示器DPI缩放终极指南：SetDPI让你的显示器完美适配

Windows多显示器DPI缩放终极指南&#xff1a;SetDPI让你的显示器完美适配 【免费下载链接】SetDPI 项目地址: https://gitcode.com/gh_mirrors/se/SetDPI 你是否曾经遇到过这样的困扰&#xff1a;连接多个显示器后&#xff0c;文字和图标在不同屏幕上大小不一&#xff…

作者头像 李华
网站建设 2026/5/16 2:49:12

PaddlePaddle去模糊Deblur模型在监控视频中的应用

PaddlePaddle去模糊Deblur模型在监控视频中的应用 在城市安防系统中&#xff0c;摄像头无处不在——十字路口、地铁站台、写字楼走廊……然而&#xff0c;当你回放一段关键录像时&#xff0c;却发现画面模糊不清&#xff1a;疾驰而过的车辆拖着长长的残影&#xff0c;行人的脸像…

作者头像 李华
网站建设 2026/5/14 21:09:33

html5-qrcode极速优化：从卡顿到流畅的实战指南

html5-qrcode极速优化&#xff1a;从卡顿到流畅的实战指南 【免费下载链接】html5-qrcode A cross platform HTML5 QR code reader. See end to end implementation at: https://scanapp.org 项目地址: https://gitcode.com/gh_mirrors/ht/html5-qrcode 在移动支付、门禁…

作者头像 李华
网站建设 2026/5/22 5:14:13

ReadCat终极指南：5分钟快速上手免费开源小说阅读神器

ReadCat终极指南&#xff1a;5分钟快速上手免费开源小说阅读神器 【免费下载链接】read-cat 一款免费、开源、简洁、纯净、无广告的小说阅读器 项目地址: https://gitcode.com/gh_mirrors/re/read-cat ReadCat是一款基于Vue3Electron技术栈打造的免费开源小说阅读器&…

作者头像 李华
网站建设 2026/5/23 18:40:20

终极Dism++指南：免费的Windows系统维护神器

终极Dism指南&#xff1a;免费的Windows系统维护神器 【免费下载链接】Dism-Multi-language Dism Multi-language Support & BUG Report 项目地址: https://gitcode.com/gh_mirrors/di/Dism-Multi-language 还在为Windows系统卡顿、磁盘空间不足而烦恼吗&#xff1f…

作者头像 李华
网站建设 2026/5/21 8:19:35

Windows安卓应用安装终极指南：APK Installer完整教程

Windows安卓应用安装终极指南&#xff1a;APK Installer完整教程 【免费下载链接】APK-Installer An Android Application Installer for Windows 项目地址: https://gitcode.com/GitHub_Trending/ap/APK-Installer 想要在Windows电脑上直接安装和运行安卓应用吗&#x…

作者头像 李华