基础知识：Python类里面的@property装饰器的作用

Tom Boom

已于 2025-05-19 16:45:43 修改

阅读量1k

点赞数 19

分类专栏：自动化测试框架设计和开发文章标签： python 开发语言自动化测试框架测试开发自动化测试装饰器

于 2025-05-19 16:30:39 首次发布

本文链接：https://blog.csdn.net/sw3300255/article/details/148067675

版权

自动化测试框架设计和开发专栏收录该内容

37 篇文章

订阅专栏

课外活动：Python类里面的@property装饰器的作用

一、@property核心作用解析

属性类型	访问方式	访问控制能力
普通属性	直接访问	无法控制访问逻辑
@property 属性	方法转属性	可以实现访问控制

1.1 核心功能

方法转属性：将方法调用转换为属性访问
访问控制：实现getter/setter逻辑
数据验证：在属性赋值时进行校验
计算属性：动态生成属性值

二、基础用法示例

2.1 基础属性转换

class Circle:
    def __init__(self, radius):
        self._radius = radius
    
    @property
    def radius(self):
        """Getter方法"""
        return self._radius
    
    @radius.setter
    def radius(self, value):
        """Setter方法"""
        if value <= 0:
            raise ValueError("半径必须大于0")
        self._radius = value

# 使用示例
c = Circle(5)
print(c.radius)  # 输出:5 (调用getter)
c.radius = 10    # 调用setter
c.radius = -1    # 抛出ValueError

执行流程：

三、高级应用场景

3.1 数据校验

class Person:
    def __init__(self, name):
        self._name = name
        self._age = 0
    
    @property
    def age(self):
        return self._age
    
    @age.setter
    def age(self, value):
        if not 0 <= value <= 150:
            raise ValueError("年龄无效")
        self._age = value

p = Person("Alice")
p.age = 25      # 正常赋值
p.age = 200     # 抛出ValueError

3.2 计算属性

class Rectangle:
    def __init__(self, width, height):
        self.width = width
        self.height = height
    
    @property
    def area(self):
        return self.width * self.height

rect = Rectangle(3,4)
print(rect.area)  # 输出12 (自动计算)
rect.area = 20    # 报错(无setter)

四、进阶用法示例

4.1 缓存计算结果

class PrimeChecker:
    def __init__(self, number):
        self._number = number
        self._is_prime = None
    
    @property
    def number(self):
        return self._number
    
    @number.setter
    def number(self, value):
        self._number = value
        self._is_prime = None  # 清空缓存
    
    @property
    def is_prime(self):
        if self._is_prime is None:
            print("执行质数计算...")
            self._is_prime = all(self._number%i!=0 for i in range(2, int(self._number**0.5)+1))
        return self._is_prime

pc = PrimeChecker(11)
print(pc.is_prime)  # 第一次计算
print(pc.is_prime)  # 直接返回缓存
pc.number = 12      # 重置缓存
print(pc.is_prime)  # 重新计算

输出结果：

执行质数计算...
True
True
执行质数计算...
False

4.2 动态更新属性

class Temperature:
    def __init__(self, celsius):
        self.celsius = celsius
    
    @property
    def fahrenheit(self):
        return self.celsius * 1.8 + 32
    
    @fahrenheit.setter
    def fahrenheit(self, value):
        self.celsius = (value - 32) / 1.8

t = Temperature(0)
print(t.fahrenheit)  # 32.0
t.fahrenheit = 77
print(t.celsius)     # 25.0

五、特殊场景应用

5.1 只读属性

class Database:
    def __init__(self, host):
        self._host = host
    
    @property
    def connection_str(self):
        return f"mysql://{self._host}:3306"

db = Database("localhost")
print(db.connection_str)  # mysql://localhost:3306
db.connection_str = ""    # 报错(无setter)

5.2 属性访问日志

class LoggedValue:
    def __init__(self):
        self._value = 0
    
    @property
    def value(self):
        print(f"读取值: {self._value}")
        return self._value
    
    @value.setter
    def value(self, v):
        print(f"设置新值: {v}")
        self._value = v

lv = LoggedValue()
lv.value = 10  # 输出:设置新值:10
x = lv.value   # 输出:读取值:10

六、@property与传统方法对比

场景	传统方法实现	@property实现	优势对比
数据校验	需要显式调用校验方法	自动触发校验逻辑	代码更简洁直观
属性访问控制	需要维护私有变量和访问方法	透明访问控制	保持接口一致性
计算属性	需要手动调用计算方法	自动按需计算	提升代码可维护性
向后兼容	修改属性需要调整所有调用代码	保持接口不变修改内部实现	降低重构成本