Python 中描述符的 __delete__ 方法仅在通过实例删除属性时被触发；直接 del Class.attr 会移除类字典中的描述符对象本身，而非调用其 __delete__，这是由描述符协议的设计机制决定的。
python 中描述符的 `__delete__` 方法仅在通过实例删除属性时被触发；直接 `del class.attr` 会移除类字典中的描述符对象本身，而非调用其 `__delete__`，这是由描述符协议的设计机制决定的。
在 Python 的描述符协议中，__delete__(self, obj) 的设计初衷是响应“从实例中删除托管属性”的操作，而非“从类中卸载描述符”。当执行 del instance.attr 时，解释器会检查 instance.__class__.attr 是否为实现了 __delete__ 的描述符，并委托调用；但执行 del Class.attr 时，Python 直接在类的 __dict__ 中执行键删除（类似 del Class.__dict__['attr']），完全绕过描述符协议——此时描述符对象本身被销毁，其 __delete__ 永远不会被调用。
以下代码清晰展示了这一行为差异：
import os
class ValueFromFile:
def __set_name__(self, owner, name):
self.name = name
self.path = os.path.join(os.getcwd(), f"{name}.pickle")
def __delete__(self, instance):
print(f"__delete__ called: removing {self.path}")
if os.path.exists(self.path):
os.remove(self.path)
class C:
value = ValueFromFile()
# ✅ 正确触发描述符 __delete__
c = C()
# 假设文件已存在
# del c.value # 输出: __delete__ called: removing ./value.pickle
# ❌ 不会调用 __delete__，而是直接从类中删除描述符
# del C.value # 无输出，C.value 变成 AttributeError
⚠️ 关键注意事项：
描述符的 __delete__ 是实例级操作钩子，与 __get__/__set__ 一样，仅在访问/修改/删除实例属性时激活；
del Class.attr 属于类结构变更操作，等价于 del Class.__dict__['attr']，不经过任何描述符方法；
-
若需在类级别触发清理逻辑（如统一释放资源），应显式设计接口，例如：
class C: value = ValueFromFile() @classmethod def cleanup_value(cls): # 手动触发描述符的清理逻辑 if hasattr(cls.value, '__delete__'): cls.value.__delete__(None) # 注意：此处传 None 作为 instance（需描述符内部兼容）
✅ 最佳实践总结：
- 将 __delete__ 视为“实例属性销毁回调”，仅用于清理与该实例关联的资源（如临时文件、缓存项）；
- 避免依赖 del Class.attr 触发业务逻辑，因其本质是元编程操作，不可预测且破坏封装；
- 如需类级别资源管理，请使用显式方法（如 cleanup()）、类装饰器或 __delattr__（谨慎重载）替代。
描述符协议的核心在于“拦截实例属性访问”，理解这一点，就能准确把握 __delete__ 的适用边界与设计意图。
