Python property属性控制详解

Python 的 `@property` 是一种优雅的编程技巧，它将方法伪装成属性，既保持了简洁自然的调用方式（如 `obj.age`），又能在取值、赋值甚至删除时无缝嵌入校验、计算、缓存或格式化等逻辑；它不提供底层访问权限控制（如 private 封装），却能灵活实现只读、可读写、带约束的写入及防误删等行为，极大提升了代码的可维护性与接口稳定性——尤其当你需要在不破坏现有调用习惯的前提下，为简单属性访问注入复杂业务逻辑时，`@property` 几乎是 Python 中不可或缺的实用利器。

Python 的 @property 不是用来“控制访问权限”的，而是把方法伪装成属性，让调用更自然，同时还能在取值/赋值时插入逻辑（比如校验、计算、缓存）。它不提供像 Java 那样的 private/public 机制，但能优雅地实现“只读”“可读写”或“带验证的写入”。

为什么用 @property？

直接暴露实例变量（如 obj.age）简单，但一旦需要加校验、日志、单位转换或延迟计算，就得改成方法调用（如 obj.get_age()），破坏原有接口。@property 让你后期加逻辑，却不改调用方式。

• 保持接口一致性：外部仍用 obj.name，内部却可做校验或格式化
• 实现只读属性：只有 getter，没 setter，外界无法修改
• 避免暴露底层数据结构：比如实际存的是 _birth_year，但提供 age 属性自动算出

@property 的基本写法（只读属性）

用 @property 装饰一个方法，它就变成可读的属性：

class Person:
    def __init__(self, birth_year):
        self._birth_year = birth_year
<pre class="brush:php;toolbar:false"><code>@property
def age(self):
    from datetime import datetime
    return datetime.now().year - self._birth_year</code>

使用：p = Person(1990); print(p.age) —— 看起来是读属性，实际执行了计算逻辑。

加上 setter 实现可读写（带校验）

用同名方法 + @xxx.setter 装饰器，就能支持赋值操作：

class Temperature:
    def __init__(self, celsius=0):
        self._celsius = celsius
<pre class="brush:php;toolbar:false"><code>@property
def celsius(self):
    return self._celsius

@celsius.setter
def celsius(self, value):
    if not isinstance(value, (int, float)):
        raise TypeError("温度必须是数字")
    if value < -273.15:
        raise ValueError("不能低于绝对零度")
    self._celsius = float(value)</code>

使用：t = Temperature(); t.celsius = 25.5 会触发校验；t.celsius = -300 报错。

可选：加上 deleter 控制删除行为

极少见，但如果你不希望别人用 del obj.attr，可以定义 deleter 并抛异常，或做清理：

    @celsius.deleter
    def celsius(self):
        raise AttributeError("温度值不允许被删除")

这样 del t.celsius 就会报错。

不复杂但容易忽略：@property 方法里别做耗时操作（比如网络请求、大文件读取），否则看似普通属性访问，实际卡住程序。真要延迟加载，建议配合缓存（如 @functools.cached_property，Python 3.8+）。

终于介绍完啦！小伙伴们，这篇关于《Python property属性控制详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！