如何在 Python 类中为多个属性统一绑定变更回调函数-Python教程-PHP中文网

本文介绍一种基于描述符（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 查询技能

查询客流数据，输出JSON格式，可直接导入Bitable等可视化工具

下载

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!

✅ 优势总结：