直接赋值绕过验证因无@property时属性为普通变量;@property提供受控访问,需配套setter实现校验,命名须一致且存储变量用下划线区分,初始化通常绕过setter以避免重复校验。

为什么直接给实例赋值会绕过验证逻辑
因为没用 @property 时,属性就是普通变量,Python 不拦截赋值动作。比如 user.age = -5 完全合法,哪怕你本意是只接受正整数。
用 @property 把字段变成“受控访问点”,才能在读写时插入校验、转换或副作用逻辑。
- 必须先定义
@xxx.setter,否则该属性只读(尝试赋值会抛AttributeError: can't set attribute) - getter 和 setter 的函数名必须一致,且不能和底层存储变量同名(否则递归调用导致
RecursionError) - 推荐用单下划线前缀(如
_age)区分内部存储变量和 property 名(如age)
怎么写一个带类型和范围检查的 setter
常见错误是只检查值但忽略类型,比如把字符串 "25" 当成合法年龄。setter 里要同时做类型判断和业务规则校验。
class User:
def __init__(self, age):
self._age = age # 直接存,不走 setter
<pre class="brush:php;toolbar:false;">@property
def age(self):
return self._age
@age.setter
def age(self, value):
if not isinstance(value, int):
raise TypeError("age must be int")
if value 150:
raise ValueError("age must be between 0 and 150")
self._age = value
- 初始化时绕过 setter 是常规做法,避免构造器里触发校验逻辑
- 如果想让初始化也走校验,可以把逻辑抽成私有方法,在
__init__和 setter 里都调用 - 注意:
isinstance(value, int)不会接受bool(因为bool是int子类),需要额外排除isinstance(value, bool)
@property 会影响性能吗?什么时候不该用
每次访问都调用函数,比直接读属性慢——但多数场景差异可忽略。真正要注意的是副作用和隐式行为。
- 如果 getter 里做了耗时操作(比如查数据库、发 HTTP 请求),用户调用
obj.field时完全意识不到这是“重操作” - 不要在 getter 里修改对象状态(比如自增计数器),这违反属性访问的直觉预期
- 纯计算型字段(如
full_name拼接两个字段)适合用@property;但频繁更新又高频读取的字段,考虑缓存或预计算 - 继承时,子类重写父类 property 的 getter/setter 不会自动调用
super(),需显式处理
为什么删除属性时抛 AttributeError 而不是 KeyError
因为 @property 定义的是属性协议的一部分,不是字典键。Python 在找不到 __delattr__ 或对应 deleter 时,统一报 AttributeError。
- 要支持
del obj.field,得额外定义@field.deleter - 多数情况下不需要实现 deleter;如果真要删,往往是清空内部状态(如
self._field = None),而非彻底移除属性 - 试图对没有 deleter 的 property 执行
del,错误信息是:AttributeError: can't delete attribute
property 的核心不是“看起来像属性”,而是控制访问时机和方式。最常被忽略的是:它让字段从数据容器变成了行为入口——一旦加了 @property,你就得对每次读写负责。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











