本文介绍一种基于描述符（descriptor）的优雅方案，无需为每个属性重复编写 property 和 setter，即可实现“当指定变量被修改时自动调用对应函数”的需求，大幅提升多属性监听场景下的代码可维护性与可读性。
本文介绍一种基于描述符（descriptor）的优雅方案，无需为每个属性重复编写 property 和 setter，即可实现“当指定变量被修改时自动调用对应函数”的需求，大幅提升多属性监听场景下的代码可维护性与可读性。
在开发中，我们常需对类属性的修改行为进行响应——例如触发校验、更新缓存、通知 UI 或执行日志记录。若使用传统 @property + @xxx.setter 模式，面对 8 个甚至更多需监听的字段时，代码将迅速变得冗长且难以维护。此时，Python 的描述符协议（Descriptor Protocol） 提供了更抽象、更复用的解决方案。
核心思路是：定义一个通用的 TriggerProperty 描述符类，它接收一个回调函数作为参数，并在 __set__ 方法中自动触发该函数；再通过类属性声明的方式，将不同变量绑定到不同回调，从而实现「声明式监听」。
以下为完整可运行示例：
class TriggerProperty:
def __init__(self, callback):
self.callback = callback
def __set_name__(self, owner, name):
# 自动推导私有属性名（如 a → _a）
self.private_name = "_" + name
self.public_name = name
def __get__(self, obj, obj_type=None):
if obj is None:
return self
return getattr(obj, self.private_name, None)
def __set__(self, obj, value):
# 避免初始化时误触发（仅在实例已存在该私有属性时才回调）
if hasattr(obj, self.private_name):
self.callback()
print(f"{self.public_name} changed!")
setattr(obj, self.private_name, value)
# 定义业务回调函数
def func1():
print("Function 1 called — triggered by a, c, or f")
def func2():
print("Function 2 called — triggered by b or e")
# 声明类，按需分配回调
class Event:
def __init__(self, a, b, c):
self.a = a # 触发 func1
self.b = b # 触发 func2
self.c = c # 触发 func1
# 声明式绑定：简洁、直观、可批量扩展
a = TriggerProperty(func1)
b = TriggerProperty(func2)
c = TriggerProperty(func1)
# 后续新增只需追加一行，例如：
# f = TriggerProperty(func1)
# e = TriggerProperty(func2)使用方式与普通属性完全一致：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
立即学习“Python免费学习笔记（深入）”；
obj = Event(1, 2, 3) obj.a = 15 # 输出：Function 1 called \n a changed! obj.b = 10 # 输出：Function 2 called \n b changed! obj.c = 5 # 输出：Function 1 called \n c changed!
✅ 优势总结：
- 零重复逻辑：所有 setter 行为由 TriggerProperty 统一封装；
- 高可读性：类顶部的属性声明清晰表达了「谁变更 → 谁响应」的映射关系；
- 易扩展：新增监控字段仅需添加一行 x = TriggerProperty(funcX)；
- 符合 Python 惯例：基于标准描述符协议，无魔法方法滥用，便于调试与继承。
⚠️ 注意事项：
- __set_name__ 是 Python 3.6+ 引入的推荐方式，用于自动获取属性名，避免硬编码；
- 初始化时（self.a = a）不会触发回调，因此时 _a 尚未存在，hasattr 返回 False，确保语义正确；
- 若需支持 del 操作或只读限制，可进一步扩展 __delete__ 或添加标志位；
- 如需传递变更前/后值给回调函数，可修改 __set__ 签名并增强 TriggerProperty 的灵活性（例如支持 lambda old, new: ...）。
这种模式特别适用于配置类、状态模型、GUI 数据绑定或实时计算图等需要响应式属性更新的场景——让关注点分离真正落地：数据定义归类体，响应逻辑归回调，绑定关系归声明行。
