Python@property详解：属性访问与设置全攻略

Python 的 `@property` 本质上是将普通属性升级为可控的行为入口，通过配套的 getter 和 setter 实现数据验证、类型检查、逻辑封装与副作用管理；它要求严格命名规范（如用 `_age` 存储、`age` 暴露）、初始化时通常绕过 setter 以避免重复校验，并警惕性能陷阱与隐式行为——比如在 getter 中执行耗时操作或修改状态会严重违背使用者对“属性访问”的直觉预期，真正关键的不是语法糖，而是意识到：一旦加上 `@property`，这个字段就不再是静态数据，而是一个需要你全程负责访问逻辑的动态接口。

为什么直接给实例赋值会绕过验证逻辑

因为没用 @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"><code>@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</code>

• 初始化时绕过 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@property详解：属性访问与设置全攻略》的详细内容，更多关于的资料请关注golang学习网公众号！