Python中可通过@property配合@xxx.deleter实现属性删除控制，deleter方法用于拦截del操作、清理资源或抛出异常，必须与getter同名且仅接收self参数。

Python 中可以通过 @property 配合 @xxx.deleter 将一个方法“伪装”成可删除的属性，实现对属性访问、赋值和删除的精细控制。

定义带 deleter 的 property

要让属性支持 del obj.attr，必须在定义 @property 的基础上，额外定义同名的 @xxx.deleter 方法。这个 deleter 方法会在执行 del 时被调用，通常用于清理资源、重置状态或抛出限制。

• deleter 方法必须与 property 的 getter 同名（即装饰的是同一个属性名）
• deleter 方法接收一个参数（self），不能有其他参数
• 它不返回值（隐式返回 None），也不影响属性本身是否真实存在——只是拦截 del 操作

一个完整示例：管理缓存字段

假设有个类缓存了计算结果，希望允许用户显式删除缓存，触发下次访问时重新计算：

class Circle:
    def __init__(self, radius):
        self._radius = radius
        self._area = None  # 缓存
@property
def area(self):
    if self._area is None:
        print("计算面积...")
        self._area = 3.14159 * self._radius ** 2
    return self._area

@area.deleter
def area(self):
    print("清除面积缓存")
    self._area = None



								


									拍我AI

AI视频生成平台PixVerse的国内版本

								下载 
							

使用方式：
c = Circle(5)
print(c.area)  # 计算面积... → 78.53975
print(c.area)  # 直接返回缓存 → 78.53975
del c.area     # 清除面积缓存
print(c.area)  # 再次计算面积... → 78.53975

注意事项与常见误区

没有定义 deleter 时，尝试 del obj.attr 会报 AttributeError: can't delete attribute

deleter 不会自动删除底层存储变量（如 self._area），需手动处理；你也可以选择不删、仅标记失效，或抛出异常禁止删除
如果只定义了 setter 和 deleter，但没定义 getter，该属性无法读取（会报错），因为 @property 装饰器本身定义的是 getter
property 名称必须一致：三个方法（getter、setter、deleter）都装饰在同一个名字上（如都叫 area）

进阶：用 deleter 实现权限控制或日志记录
你可以利用 deleter 做更多事，比如记录谁删了属性、检查权限、或联动更新其他状态：
@cached_value.deleter
def cached_value(self):
    if not self.can_modify:
        raise PermissionError("无权清除缓存")
    self._cache_timestamp = None
    self._log_event("cached_value deleted by user")

这种模式让属性接口干净（del obj.data），背后逻辑却高度可控。
https://www.php.cn/faq/2014635.html