Skip to content

属性(Property)

一句话解释

@property 让你像访问属性一样访问方法,实现验证、计算或封装。

用大白话说

@property 装饰器将方法变为像属性一样访问的东西(无括号)。这让你可以:1. 访问时计算值——circle.area 而非 circle.area()

  1. 添加验证——设置时检查值
  2. 封装——在不改变公共 API 的情况下更改内部存储
  3. 创建只读属性——定义 getter 不定义 setter

用 @property 做 getter,@x.setter 做 setter,@x.deleter 做删除。这是 Python 无需 Java 式冗长的 getter/setter 方式。

示例

python
class Temperature:
    def __init__(self, celsius=0):
        self.celsius = celsius  # Goes through setter
    
    @property
    def fahrenheit(self):
        return self._celsius * 9/5 + 32
    
    @fahrenheit.setter
    def fahrenheit(self, value):
        self._celsius = (value - 32) * 5/9
    
    @property
    def celsius(self):
        return self._celsius
    
    @celsius.setter
    def celsius(self, value):
        if value < -273.15:
            raise ValueError("Below absolute zero!")
        self._celsius = value

t = Temperature(100)
print(t.fahrenheit)  # 212.0 — looks like attribute access
t.fahrenheit = 32
print(t.celsius)     # 0.0

@property 使方法访问看起来像属性访问。setter 验证输入——尝试设置低于 -273.15 会引发 ValueError。

常见混淆

  • 容易混淆的对象: 属性

    关键区别: 普通属性是简单存储(obj.x = 5)。属性是伪装成属性的方法——它可以在每次访问/设置时计算、验证或转换。属性让你稍后添加逻辑而无需更改公共 API。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表