本文共 1933 字，大约阅读时间需要 6 分钟。

Python 中 property() 函数及 @property 装饰器的使用

0. 参考资料

1. property 应用场景

• 在获取、设置和删除对象属性的时候，需要额外做一些工作。比如在游戏编程中，设置敌人死亡之后需要播放死亡动画。
• 需要限制对象属性的设置和获取。比如用户年龄为只读，或者在设置用户年龄的时候有范围限制。
• 这时就可以使用 property 工具，它把方法包装成属性，让方法可以以属性的形式被访问和调用。

2. property() 函数

• 语法：
  property(fget=None, fset=None, fdel=None, doc=None) -> property attribute
• 说明：
  • fget 是获取属性值的方法。
  • fset 是设置属性值的方法。
  • fdel 是删除属性值的方法。
  • doc 是属性描述信息。如果省略，会把 fget 方法的 docstring 拿来用（如果有的话）
• 示例代码：

class Student:    def __init__(self):        self._age = None    def get_age(self):        print('获取属性时执行的代码')        return self._age    def set_age(self, age):        print('设置属性时执行的代码')        self._age = age    def del_age(self):        print('删除属性时执行的代码')        del self._age    age = property(get_age, set_age, del_age, '学生年龄')student = Student()# 注意要用 类名.属性.__doc__ 的形式查看属性的文档字符串print('查看属性的文档字符串：' + Student.age.__doc__)"""查看属性的文档字符串：学生年龄"""# 设置属性student.age = 18"""设置属性时执行的代码"""# 获取属性print('学生年龄为：' + str(student.age))"""获取属性时执行的代码学生年龄为：18"""# 删除属性del student.age"""删除属性时执行的代码"""

3. @property 装饰器

@property 语法糖提供了比 property() 函数更简洁直观的写法。

• 被 @property 装饰的方法是获取属性值的方法，被装饰方法的名字会被用做 属性名。
• 被 @属性名.setter 装饰的方法是设置属性值的方法。
• 被 @属性名.deleter 装饰的方法是删除属性值的方法。

以下示例代码与使用 property() 函数版本的代码等价：

class Student:    def __init__(self):        self._age = None    @property    def age(self):        print('获取属性时执行的代码')        return self._age    @age.setter    def age(self, age):        print('设置属性时执行的代码')        self._age = age    @age.deleter    def age(self):        print('删除属性时执行的代码')        del self._agestudent = Student()# 设置属性student.age = 18"""设置属性时执行的代码"""# 获取属性print('学生年龄为：' + str(student.age))"""获取属性时执行的代码学生年龄为：18"""# 删除属性del student.age"""删除属性时执行的代码"""

4. 注意事项

• 可以省略设置属性值的方法，此时该属性变成只读属性。如果此时仍然设置属性，会抛出异常 AttributeError: can't set attribute。
• 如果报错 RecursionError: maximum recursion depth exceeded while calling a Python object，很可能是对象属性名和 @property 装饰的方法名重名了，一般会在对象属性名前加一个下划线 _ 避免重名，并且表明这是一个受保护的属性。

完成于 20181113