直接赋值绕过验证因无@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 < 0 or value > 150:
raise ValueError("age must be between 0 and 150")
self._age = value
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
立即学习“Python免费学习笔记（深入）”；
- 初始化时绕过 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，你就得对每次读写负责。
