讲师中心 微信公众号

工具推荐

视频效率加速
SoundView
SoundView

字幕擦除翻译、配音口型同步

Seko
Seko

AI短剧一键生成成片

Laper
Laper

剧本策划到成片协作

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Python描述符中属性名称冲突导致无限递归的解析与实践

陌雪吖_9030

陌雪吖_9030

发布时间:2025-11-10 13:21:01

|

983人浏览过

|

来源于php中文网

原创

Python描述符中属性名称冲突导致无限递归的解析与实践

本文深入探讨了python描述符在使用过程中,当描述符内部用于存储数据的属性名与外部管理属性名相同时,为何会导致无限递归的问题。通过剖析描述符协议的调用机制,揭示了这种命名冲突如何触发`__set__`方法的循环调用。文章提供了清晰的代码示例,并强调了使用不同内部属性名(如加前缀`_`)来安全实现描述符的关键实践,旨在帮助开发者避免此类常见陷阱,提升代码的健壮性。

Python 描述符与属性管理

Python 描述符(Descriptor)是一种强大的机制,允许开发者自定义对象属性的访问、修改和删除行为。它通过实现特殊方法 __get__、__set__ 和 __delete__ 来工作。当一个类属性被赋值为一个描述符实例时,对该类实例上同名属性的访问就会被描述符的方法所拦截。

例如,我们可以创建一个描述符来记录属性的访问和修改日志:

import logging

logging.basicConfig(level=logging.INFO)

class LoggedAgeAccess:
    """
    一个记录年龄属性访问和修改的描述符。
    它将实际的年龄值存储在拥有者对象的 _age 属性中。
    """
    def __get__(self, obj, objtype=None):
        if obj is None:
            return self # 如果通过类访问,返回描述符本身
        value = obj._age # 从拥有者对象的私有属性中获取值
        logging.info('Accessing %r giving %r', 'age', value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', 'age', value)
        obj._age = value # 将值存储到拥有者对象的私有属性中

class Person:
    age = LoggedAgeAccess() # 将 LoggedAgeAccess 实例作为 Person 类的 age 属性

    def __init__(self, name, age):
        self.name = name
        self.age = age # 调用描述符的 __set__ 方法

    def birthday(self):
        self.age += 1 # 调用描述符的 __get__ 和 __set__ 方法

在上述示例中,LoggedAgeAccess 描述符管理 Person 类的 age 属性。它将实际的年龄值存储在 Person 实例的 _age 属性中。当我们创建 Person 实例并设置 age 时,LoggedAgeAccess.__set__ 方法会被调用;当我们访问 age 时,LoggedAgeAccess.__get__ 方法会被调用。

mary = Person('Mary M', 30)
# 输出: INFO:root:Updating 'age' to 30
print(vars(mary))
# 输出: {'name': 'Mary M', '_age': 30}

可以看到,age 属性通过描述符被管理,实际的数据存储在 _age 中,避免了命名冲突。

立即学习“Python免费学习笔记(深入)”;

命名冲突引发的无限递归

然而,如果我们在描述符内部使用与外部管理属性相同的名称来存储数据,就会导致一个常见的陷阱——无限递归。

考虑以下修改后的 LoggedAgeAccess 描述符,它尝试将值存储在 obj.age 而不是 obj._age 中:

class LoggedAgeAccessBroken:
    """
    一个错误的描述符实现,将导致无限递归。
    它尝试将实际的年龄值存储在拥有者对象的 age 属性中。
    """
    def __get__(self, obj, objtype=None):
        if obj is None:
            return self
        # 问题所在:访问 obj.age 会再次触发描述符的 __get__ 方法
        value = obj.age
        logging.info('Accessing %r giving %r', 'age', value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', 'age', value)
        # 问题所在:设置 obj.age 会再次触发描述符的 __set__ 方法
        obj.age = value

class PersonBroken:
    age = LoggedAgeAccessBroken() # 将 LoggedAgeAccessBroken 实例作为 PersonBroken 类的 age 属性

    def __init__(self, name, age):
        self.name = name
        self.age = age # 尝试调用描述符的 __set__ 方法

当我们尝试使用 PersonBroken 类时:

Python健壮编程
Python健壮编程

编写可靠Python代码,避免可变默认值、导入陷阱与运行时意外

下载
# mary_broken = PersonBroken('Mary B', 30)

程序会陷入一个无限循环,不断输出 INFO:root:Updating 'age' to 30,最终可能导致栈溢出错误。

无限递归的机制解析

这个无限递归的根本原因在于 Python 的描述符协议。当一个类的属性(例如 PersonBroken.age)是一个描述符实例时,对该类的实例属性(例如 mary_broken.age)的访问或设置,都会首先通过描述符协议进行处理。

具体来说:

  1. 当执行 self.age = age (在 PersonBroken.__init__ 中)时,Python 解释器发现 PersonBroken.age 是一个描述符。
  2. 于是,它会调用 LoggedAgeAccessBroken.__set__(self, age)。
  3. 进入 LoggedAgeAccessBroken.__set__ 方法内部,执行 obj.age = value。
  4. 此时,obj 实际上就是 mary_broken 实例。对 mary_broken.age 的赋值操作,再次触发了描述符协议。
  5. 解释器再次发现 PersonBroken.age 是一个描述符,于是再次调用 LoggedAgeAccessBroken.__set__(obj, value)。
  6. 这个过程无限重复,形成递归调用,直到系统资源耗尽。

同样的问题也存在于 __get__ 方法中。如果 __get__ 方法内部尝试访问 obj.age,也会再次触发描述符的 __get__ 方法,导致无限递归。

解决方案与最佳实践

解决这个问题的关键在于,描述符内部用于存储实际数据的属性名,必须与描述符所管理的外部属性名不同。通常的做法是,在拥有者对象上使用一个带前缀(如 _ 或 __)的私有属性名来存储数据。

正确的实现方式

回到最初的正确示例,LoggedAgeAccess 描述符通过 obj._age 来存储和访问数据,从而避免了与外部 age 属性的冲突。

import logging

logging.basicConfig(level=logging.INFO)

class LoggedAgeAccess:
    """
    正确的描述符实现,使用不同的内部属性名来存储数据。
    """
    def __get__(self, obj, objtype=None):
        if obj is None:
            return self
        # 访问拥有者对象的私有属性 _age
        value = obj._age
        logging.info('Accessing %r giving %r', 'age', value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', 'age', value)
        # 将值存储到拥有者对象的私有属性 _age
        obj._age = value

class Person:
    age = LoggedAgeAccess()

    def __init__(self, name, age):
        self.name = name
        self.age = age # 正常调用描述符的 __set__ 方法

    def birthday(self):
        self.age += 1 # 正常调用描述符的 __get__ 和 __set__ 方法

其他存储方式

除了在拥有者对象上使用不同的私有属性名外,描述符还可以使用其他方式来存储数据,例如:

  • 直接在描述符实例上存储(不常见,因为描述符通常是类属性,所有实例共享):如果描述符是每个实例独有的,可以在 __set__ 中存储到 self.value。
  • 使用 obj.__dict__ 直接操作实例字典:通过 obj.__dict__['age'] = value 可以绕过描述符协议,直接在实例的字典中设置或获取值。这在某些高级场景下很有用,但通常不如使用 _age 这种约定俗成的私有属性名直观。
  • 使用 weakref.WeakKeyDictionary 或 weakref.WeakValueDictionary:对于需要存储大量实例特定数据的描述符,可以使用弱引用字典来避免内存泄漏。

注意事项

  • 命名约定:在 Python 中,以单个下划线 _ 开头的属性通常表示“受保护”或“内部使用”,提醒开发者不应直接访问。双下划线 __ 开头的属性会触发名称改编(name mangling),使其在外部更难访问。
  • 理解描述符协议:深入理解 __get__、__set__ 和 __delete__ 方法的调用时机和参数是正确使用描述符的关键。
  • 避免循环引用:在设计复杂的描述符时,要注意避免可能导致内存泄漏的循环引用。

总结

Python 描述符是实现高级属性管理和元编程的强大工具。然而,在使用它们时,必须注意避免内部存储属性与外部管理属性同名的问题,这会导致无限递归。通过在拥有者对象上使用不同的、通常是带前缀的私有属性名来存储实际数据,可以有效地解决这一问题,确保描述符的正确和安全运行。掌握这一关键概念,将帮助开发者编写更健壮、更符合 Python 惯例的代码。

热门AI工具

更多
创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

相关专题

更多
堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

7227

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2948

2023.08.10

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

0

2026.11.17

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

0

2026.11.17

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

0

2026.11.17

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

0

2026.11.17

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

0

2026.11.17

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

160

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn