深入理解Python __setattr__方法（全面解析Python属性设置与魔术方法）

基本语法

标准的 __setattr__ 方法签名如下：

def __setattr__(self, name, value):    # 自定义逻辑    super().__setattr__(name, value)  # 或者 self.__dict__[name] = value

• self：当前实例对象
• name：要设置的属性名称（字符串）
• value：要赋予该属性的值

简单示例：记录属性设置日志

下面是一个使用 __setattr__ 记录每次属性赋值的日志示例：

class Person:    def __init__(self, name, age):        self.name = name        self.age = age    def __setattr__(self, name, value):        print(f"正在设置属性 '{name}' 为 '{value}'")        # 使用 object.__setattr__ 避免无限递归        object.__setattr__(self, name, value)# 测试tom = Person("Tom", 25)tom.age = 26

输出结果：

正在设置属性 'name' 为 'Tom'正在设置属性 'age' 为 25正在设置属性 'age' 为 26

⚠️ 重要警告：避免无限递归

如果你在 __setattr__ 中直接写 self.name = value，会导致无限递归，因为这又会触发 __setattr__！

# ❌ 错误示范 —— 会导致 RecursionErrordef __setattr__(self, name, value):    self.name = value  # 这会再次调用 __setattr__，无限循环！

✅ 正确做法是使用以下任一方式：

• object.__setattr__(self, name, value)（推荐）
• self.__dict__[name] = value

实战应用：只读属性或类型检查

我们可以利用 __setattr__ 实现更高级的功能，例如限制某些属性不可修改，或强制类型验证。

class BankAccount:    def __init__(self, balance):        self._balance = float(balance)  # 初始余额        self.account_readonly = True     # 标记只读    def __setattr__(self, name, value):        if name == "account_readonly":            # 允许首次设置            if not hasattr(self, "account_readonly"):                object.__setattr__(self, name, value)            else:                raise AttributeError("'account_readonly' 属性不可修改！")        elif name == "_balance":            if not isinstance(value, (int, float)):                raise TypeError("余额必须是数字！")            if value < 0:                raise ValueError("余额不能为负数！")            object.__setattr__(self, name, value)        else:            object.__setattr__(self, name, value)# 测试acc = BankAccount(1000)acc._balance = 1500      # ✅ 合法# acc._balance = -100    # ❌ 报错：余额不能为负数！# acc.account_readonly = False  # ❌ 报错：不可修改！

与其他魔术方法的关系

在 Python魔术方法体系中，__setattr__ 常与以下方法配合使用：

• __getattr__：当访问不存在的属性时调用
• __getattribute__：访问任何属性时都调用（优先级高于 __getattr__）
• __delattr__：删除属性时调用

总结

__setattr__ 是 Python属性设置机制的核心，通过它我们可以实现属性拦截、验证、日志记录、只读控制等强大功能。但务必注意避免无限递归，并合理使用 object.__setattr__ 或 __dict__ 来完成实际赋值。

掌握 __setattr__ 不仅能提升你对 Python面向对象编程的理解，还能让你写出更健壮、更灵活的代码。希望这篇教程能帮助你轻松入门并熟练运用这一关键的Python魔术方法！

© 2023 Python 编程教程 | 深入理解 __setattr__ 方法