一文搞懂Python對象的描述器機制

更新時間：2025年05月29日 08:30:46 作者：燭陰

在Python中,“描述器”是一種能夠自定義對象屬性訪問（獲取、設置、刪除）行為的協(xié)議,它是實現(xiàn)@property、類屬性、ORM字段、類型檢查的底層支撐,本文將帶你玩轉(zhuǎn)Python對象的描述器機制,需要的朋友可以參考下

一、什么是Python描述器？

在Python中，“描述器”是一種能夠自定義對象屬性訪問（獲取、設置、刪除）行為的協(xié)議。它是實現(xiàn)@property、類屬性、ORM字段、類型檢查的底層支撐。

一句話解釋：只要一個對象定義了__get__、__set__或__delete__等特殊方法，并作為另一個類的類屬性，這個對象就成了描述器！

默認對屬性的訪問控制是從對象的字典里面 (__dict__) 中獲取 (get) , 設置 (set) 和刪除 (delete) 。

舉例來說， a.x 的查找順序是, a.__dict__['x'] , 然后 type(a).__dict__['x'] , 然后找 type(a) 的父類 ( 不包括元類 (metaclass) ).如果查找到的值是一個描述器, Python 就會調(diào)用描述器的方法來重寫默認的控制行為。

二、描述器協(xié)議：三大魔法方法

方法	作用	用法場景
__get__	獲取屬性時調(diào)用	動態(tài)計算、懶加載
__set__	設置屬性時調(diào)用	數(shù)據(jù)驗證、只讀限制
__delete__	刪除屬性時調(diào)用	管控屬性生命周期

最簡單的描述器雛形：

class DemoDescriptor:
    def __get__(self, instance, owner):
        print('執(zhí)行了__get__')
        return 42

class MyClass:
    x = DemoDescriptor()

obj = MyClass()
print(obj.x)  # 輸出42，中間會打印“執(zhí)行了__get__”

三、入門實戰(zhàn)：搞懂描述器工作的方式

3.1 數(shù)據(jù)描述器 VS 非數(shù)據(jù)描述器

數(shù)據(jù)描述器 ：同時定義了__get__和__set__
非數(shù)據(jù)描述器 ：只定義了__get__

數(shù)據(jù)描述器擁有更高優(yōu)先級，會屏蔽實例字典上的同名屬性！

3.2 數(shù)據(jù)描述器基礎案例

class Typed:
    def __init__(self, name, typ):
        self.name = name
        self.typ = typ

    def __get__(self, instance, owner):
        return instance.__dict__[self.name]

    def __set__(self, instance, value):
        if not isinstance(value, self.typ):
            raise TypeError(f'屬性{self.name}必須是{self.typ}')
        instance.__dict__[self.name] = value

class Person:
    age = Typed('age', int)    # 用描述器控制
    name = Typed('name', str)

p = Person()
p.age = 18            # 自動類型檢查
p.name = '小明'
# p.age = 'not int'   # 拋出TypeError

四、@property 與描述器的關(guān)系

你用過的@property，其實就是“非數(shù)據(jù)描述器”的語法糖：

class Demo:
    @property
    def val(self):
        return 666

底層實現(xiàn)和你定義帶__get__的對象如出一轍。

五、進階：自定義描述器封裝與通用實現(xiàn)

5.1 描述器工廠基于裝飾器快速生成校驗字段

def typed_field(name, typ):
    class _TypedDescriptor:
        def __get__(self, instance, owner):
            return instance.__dict__[name]
        def __set__(self, instance, value):
            if not isinstance(value, typ):
                raise TypeError(f"屬性{name}必須是{typ}")
            instance.__dict__[name] = value
    return _TypedDescriptor()

class Student:
    age = typed_field('age', int)
    name = typed_field('name', str)

stu = Student()
stu.age = 18    # √
# stu.age = 'oops' # TypeError

5.2 只讀屬性描述器

class ReadOnly:
    def __init__(self, value):
        self._value = value
    def __get__(self, instance, owner):
        return self._value

class System:
    version = ReadOnly('1.0.0')

print(System.version)   # '1.0.0'

到此這篇關(guān)于一文搞懂Python對象的描述器機制的文章就介紹到這了,更多相關(guān)Python對象描述器內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: