Python 内置函数：property()|property|python|spiderlinebreak|内置函数|字符串|描述符|深度思考按钮|调用

在面向对象编程中，我们常常需要对类的属性访问进行控制。例如，某些属性需要在获取时自动计算，或在设置时进行验证。Python 提供了内置函数 property()，它能将类的方法转换为“属性访问”的形式，从而实现更优雅的封装。

一、函数语法

property(fget=None, fset=None, fdel=None, doc=None)

参数：

fget：可选。获取属性值的函数（对应 getter）。

fset：可选。设置属性值的函数（对应 setter）。

fdel：可选。删除属性值的函数（对应 deleter）。

doc：可选。属性的文档字符串。

返回值：

返回一个 property 对象，可以作为类的属性使用。

二、基础用法示例

1、使用 property() 创建只读属性

class Circle:
    def __init__(self, radius):
        self._radius = radius

    def get_area(self):
        return 3.14 * self._radius ** 2

    area = property(get_area)    # area 就是通过 property() 创建的只读属性

c = Circle(5)
print(c.area)  # 78.5
# c.area = 100  # AttributeError: can't set attribute

2、定义 getter、setter、deleter

class Person:
    def __init__(self, name):
        self._name = name

    def get_name(self):
        return self._name

    def set_name(self, value):
        if not isinstance(value, str):
            raise ValueError("名字必须是字符串")
        self._name = value

    def del_name(self):
        print("删除名字属性")
        del self._name

    name = property(get_name, set_name, del_name, "姓名属性")

p = Person("Alice")
print(p.name)     # 读取 → 调用 get_name
p.name = "Bob"    # 写入 → 调用 set_name
del p.name        # 删除 → 调用 del_name

三、进阶技巧

1、使用装饰器语法

在现代 Python 中，通常用 @property 装饰器及其配套的 @ .setter、@ .deleter 来代替直接调用 property()。

class Rectangle:
    def __init__(self, width, height):
        self._width = width
        self._height = height

    @property
    def area(self):
        return self._width * self._height

    @property
    def width(self):
        return self._width

    @width.setter
    def width(self, value):
        if value <= 0:
            raise ValueError("宽度必须为正数")
        self._width = value

r = Rectangle(3, 4)
print(r.area)   # 12
r.width = 10
print(r.area)   # 40

2、控制属性访问逻辑

property() 常用于：

（1）数据验证（setter 中做检查）。

（2）只读属性（只定义 getter）。

（3）懒加载计算（在 getter 中动态生成）。

（4）封装内部实现（外部访问时仍像普通属性）。

四、property() 特点

property 对象本质上是一个数据描述符，通过 __get__、__set__、__delete__ 方法实现属性访问控制。

1、优点

统一了“方法调用”和“属性访问”的接口形式，提高代码可读性。

保持对外接口不变的情况下，可以随时在内部增加逻辑。

2、兼容性