相关链接
1. @property与描述符本质实现
2. 惰性属性使用

@property 是描述符协议的高层封装，适用于简单属性逻辑；自定义描述符则提供更灵活的底层控制，适合复杂或复用场景。开发者应根据需求选择合适方案，平衡代码简洁性与扩展性。

一、@property 的本质与实现

1. 将方法转换为属性

@property 装饰器通过将类方法封装为属性，使开发者能以访问属性的形式调用方法，同时可在方法内部添加逻辑（如数据校验、动态计算）。

class Student:
    def __init__(self, math):
        self._math = math
    
    @property
    def math(self):
        return self._math  # 直接返回私有变量
    
    @math.setter
    def math(self, value):
        if 0 <= value <= 100:  # 校验逻辑
            self._math = value
        else:
            raise ValueError("数学成绩需在 0~100 之间") 

2. 底层基于描述符协议

@property 本质是 property() 函数的语法糖，而 property() 本身是一个数据描述符（实现了 __get__ 和 __set__ 方法），用于控制属性的读写行为。

二、描述符协议的核心机制

1. 描述符的定义

描述符是实现了 __get__、__set__ 或 __delete__ 方法的类，分为两类：

• 数据描述符：同时实现 __get__ 和 __set__（如 property）
• 非数据描述符：仅实现 __get__（如类方法 @classmethod）。

2. 优先级规则

属性访问时，Python 按以下顺序查找：

• 数据描述符 → 实例属性 → 非数据描述符 → 类属性 → 内置属性。

3. 动态属性管理示例

class RangeValidator:
    def __init__(self, min_val, max_val):
        self.min = min_val
        self.max = max_val
    
    def __set__(self, instance, value):
        if not (self.min <= value <= self.max):
            raise ValueError(f"值需在 {self.min}~{self.max} 之间")
        instance.__dict__[self.name] = value  # 存储到实例命名空间
    
    def __set_name__(self, owner, name):
        self.name = name  # 自动捕获属性名称

class Product:
    price = RangeValidator(0, 1000)  # 类属性为描述符实例
    weight = RangeValidator(1, 50)

p = Product()
p.price = 500  # 触发 RangeValidator.__set__ 校验

三、@property 与描述符的关系

四、应用场景与选择建议

1. 优先使用 @property 的场景

• 单个属性的读写控制（如类型校验、动态计算）
• 需要快速封装私有属性为公共接口。

2. 优先使用描述符的场景

• 批量管理同类属性（如多个字段的通用校验规则）
• 框架级功能扩展（如 ORM 中的字段类型映射）
• 跨类复用逻辑（如统一单位转换规则）。

五、最佳实践

1. 避免过度使用 @property

复杂逻辑建议拆分为描述符，以提升代码可维护性。

2. 描述符与 __dict__ 的配合

在 __set__ 方法中操作 instance.__dict__ 可绕过描述符优先级问题。

3. 动态属性名捕获

通过 __set_name__ 方法自动获取类属性名称，避免硬编码。

六、执行效率对比

七、优化策略

• 缓存计算结果：在 @property 的 __get__ 方法中缓存值，减少重复计算。

• 避免过度封装：简单属性直接使用实例变量，而非强制通过 @property 访问。

• 描述符的 __dict__ 操作：通过直接操作实例字典绕过描述符协议的部分开销。