Python全栈修炼之路 | 第15篇 ：描述符与属性访问控制

本文是《Python全栈修炼之路》系列的第15篇，属于进阶修炼篇前半部分。适合已掌握Python基础语法，希望深入理解Python核心机制的读者。

前言

描述符（Descriptor）是Python中一个强大但常被忽视的特性。它是实现property、classmethod、staticmethod以及ORM框架的底层机制。理解描述符，才能真正理解Python的属性访问控制。

本文将深入探讨描述符协议、属性查找机制，并通过实战项目展示描述符的强大功能。

一、知识点讲解

1.1 什么是描述符

描述符是实现了描述符协议的类，即实现了以下一个或多个特殊方法：

• __get__(self, obj, objtype=None)：获取属性值
• __set__(self, obj, value)：设置属性值
• __delete__(self, obj)：删除属性

classDescriptor:"""最简单的描述符示例"""def__get__(self,obj,objtype=None):print(f"__get__ 被调用: obj={obj}, objtype={objtype}")return"描述符值"def__set__(self,obj,value):print(f"__set__ 被调用: obj={obj}, value={value}")def__delete__(self,obj):print(f"__delete__ 被调用: obj={obj}")classMyClass:attr=Descriptor()# 类属性是描述符实例obj=MyClass()# 访问属性print(obj.attr)# 调用 __get__# 设置属性obj.attr=100# 调用 __set__# 删除属性delobj.attr# 调用 __delete__

1.2 数据描述符 vs 非数据描述符

根据实现的方法不同，描述符分为两类：

优先级差异示例：

classDataDescriptor:"""数据描述符"""def__get__(self,obj,objtype=None):return"数据描述符的值"def__set__(self,obj,value):print(f"数据描述符阻止设置:{value}")classNonDataDescriptor:"""非数据描述符"""def__get__(self,obj,objtype=None):return"非数据描述符的值"classMyClass:data_attr=DataDescriptor()non_data_attr=NonDataDescriptor()obj=MyClass()# 数据描述符优先级高于实例属性obj.data_attr="新值"# 调用 __set__，实例属性不会被创建print(obj.data_attr)# "数据描述符的值"print(obj.__dict__)# {}（没有data_attr）# 非数据描述符优先级低于实例属性print(obj.non_data_attr)# "非数据描述符的值"obj.non_data_attr="实例属性值"# 创建实例属性print(obj.non_data_attr)# "实例属性值"（实例属性覆盖了描述符）print(obj.__dict__)# {'non_data_attr': '实例属性值'}

1.3 描述符方法详解

__get__(self, obj, objtype=None)

classTypedAttribute:"""类型检查描述符"""def__init__(self,name,expected_type):self.name=name self.expected_type=expected_type self.private_name=f"_{name}"def__get__(self,obj,objtype=None):ifobjisNone:# 通过类访问时，返回描述符自身returnselfreturngetattr(obj,self.private_name,None)def__set__(self,obj,value):ifnotisinstance(value,self.expected_type):raiseTypeError(f"{self.name}必须是{self.expected_type.__name__}类型，"f"而不是{type(value).__name__}")setattr(obj,self.private_name,value)classPerson:name=TypedAttribute("name",str)age=TypedAttribute("age",int)def__init__(self,name,age):self.name=name self.age=age# 使用p=Person("Alice",25)print(p.name)# Alice# p.age = "25" # TypeError: age 必须是 int 类型，而不是 str

__set__(self, obj, value)

classValidatedAttribute:"""带验证的描述符"""def__init__(self,min_value=None,max_value=None):self.min_value=min_value self.max_value=max_value self.values={}# 使用字典存储，避免实例属性冲突def__set__(self,obj,value):ifself.min_valueisnotNoneandvalue<self.min_value:raiseValueError(f"值不能小于{self.min_value}")ifself.max_valueisnotNoneandvalue>self.max_value:raiseValueError(f"值不能大于{self.max_value}")self.values[id(obj)]=valuedef__get__(self,obj,objtype=None):ifobjisNone:returnselfreturnself.values.get(id(obj))classTemperature:celsius=ValidatedAttribute