本文介绍一种基于描述符（descriptor）的简洁方案，用于在类属性被修改时自动触发指定函数，避免为每个属性重复编写 property + setter，特别适合拥有大量需监听字段的场景。
本文介绍一种基于描述符（descriptor）的简洁方案，用于在类属性被修改时自动触发指定函数，避免为每个属性重复编写 property + setter，特别适合拥有大量需监听字段的场景。
在开发中，我们常需要对类中某些字段的变更做出响应——例如更新缓存、触发事件、校验数据或刷新 UI。当字段数量较多（如 8 个以上）时，为每个字段单独定义 @property 和 @xxx.setter 不仅冗长，还严重降低可维护性与可读性。此时，自定义描述符（Descriptor） 是更优雅、可复用的解决方案。
下面是一个轻量级、生产就绪的 TriggerProperty 描述符实现：
class TriggerProperty:
def __init__(self, callback):
self.callback = callback
def __set_name__(self, owner, name):
self.private_name = f"_{name}"
self.public_name = name
def __get__(self, obj, objtype=None):
if obj is None:
return self
return getattr(obj, self.private_name)
def __set__(self, obj, value):
# 避免初始化时误触发（如 __init__ 中首次赋值）
if hasattr(obj, self.private_name):
self.callback()
print(f"{self.public_name} changed!")
setattr(obj, self.private_name, value)该描述符通过 __set__ 拦截赋值操作，在属性已存在（即非首次初始化）时执行回调，并打印提示。关键点在于：
- __set_name__ 自动获取属性名并生成私有存储名（如 a → _a），无需手动传参；
- hasattr(obj, self.private_name) 确保仅在「修改」而非「初始化」时触发回调，防止 __init__ 中的赋值误触发逻辑；
- 所有逻辑封装在单一类中，复用性极强。
使用方式极其简洁：在类体中直接声明类属性即可完成绑定：
立即学习“Python免费学习笔记（深入）”；
def func1():
print("Function 1 called")
def func2():
print("Function 2 called")
class Event:
def __init__(self, a, b, c, d, e, f):
# 初始化时直接赋值，不触发回调
self.a = a
self.b = b
self.c = c
self.d = d
self.e = e
self.f = f
# 声明哪些字段变更时调用哪个函数 —— 一目了然，高度可配置
a = TriggerProperty(func1) # a 变更 → func1
b = TriggerProperty(func2) # b 变更 → func2
c = TriggerProperty(func1) # c 变更 → func1
d = TriggerProperty(func1) # d 变更 → func1
e = TriggerProperty(func2) # e 变更 → func2
f = TriggerProperty(func1) # f 变更 → func1测试效果：
obj = Event(1, 2, 3, 4, 5, 6) obj.a = 10 # → Function 1 called \n a changed! obj.b = 20 # → Function 2 called \n b changed! obj.f = 60 # → Function 1 called \n f changed!
✅ 优势总结：
- ✅ 零重复代码：无需为每个字段写独立 setter；
- ✅ 集中配置：所有触发规则在类定义头部清晰罗列，便于维护和审计；
- ✅ 完全兼容：支持常规属性访问（obj.a）、赋值（obj.a = x）及继承；
- ✅ 可扩展性强：可轻松增强为支持参数化回调、条件触发、异步通知等高级能力。
⚠️ 注意事项：
- 描述符必须定义为类变量（即在 class 作用域内），不能在 __init__ 中动态创建；
- 若需支持 delattr 或更严格的类型校验，可在 __delete__ 或 __set__ 中补充逻辑；
- 回调函数应尽量保持轻量，避免阻塞主线程（尤其在 GUI 或 Web 框架中）；
- 如需支持 __slots__，请确保 private_name 与 slots 声明一致。
通过这一模式，你只需一行声明即可建立“字段 ↔ 回调”的映射关系，让复杂的状态响应逻辑变得清晰、简洁且健壮。
