Python中@property的理解和使用示例

追风的人

发布时间：2026-10-12 | 2人浏览过

原创

本文详解Python中@property装饰器的用法。通过学生成绩管理示例，展示如何替代传统的get/set方法，在保持参数校验逻辑的同时，实现类似普通属性的简洁调用方式。涵盖只读属性、读写属性及赋值拦截的实现细节，帮助开发者写出更优雅、安全的Python代码。

本文通过具体实例解析Python中@property装饰器的原理与应用，供读者参考学习。

回顾相关技术书籍时，注意到User表定义中涉及如下代码片段：

  @property
  def password(self):
    raise AttributeError('password is not a readable attribute')
  @password.setter
  def password(self, password):
    self.password_hash = generate_password_hash(password)

借此机会重新梳理@property的具体使用方式。

在定义数据库字段类时，通常需要对类属性进行限制。传统做法是使用get和set方法，但在Python中，如何利用@property装饰器以更少代码实现优雅的限制并降低出错率？这正是@property发挥作用的地方。

通过代码示例可以更直观地理解。例如，定义一个学生成绩表类如下：

class Student(object):
  def get_score(self):
    return self._score
  def set_score(self, value):
    if not isinstance(value, int):
      raise ValueError('score must be an integer!')
    if value < 0 or value > 100:
      raise ValueError('score must between 0 ~ 100!')
    self._score = value

传统调用方式需显式调用方法：

>>> s = Student()
>>> s.set_score(60) # ok!
>>> s.get_score()
60
>>> s.set_score(9999)
Traceback (most recent call last):
 ...
ValueError: score must between 0 ~ 100!

为提升便利性，我们希望避免书写s.set_score(9999)这样的冗长代码，而是直接通过s.score = 9999进行赋值。既然添加方法限制不应增加调用复杂度，@property装饰器便提供了理想的解决方案。

class Student(object):
  @property
  def score(self):
    return self._score
  @score.setter
  def score(self,value):
    if not isinstance(value, int):
      raise ValueError('分数必须是整数才行呐')
    if value < 0 or value > 100:
      raise ValueError('分数必须0-100之间')
    self._score = value

由上述代码可见，将get方法转换为属性只需添加@property装饰器。此时，@property装饰器会自动创建另一个装饰器@score.setter，用于处理set方法的赋值逻辑。完成此配置后，调用过程既具备可控性又保持简洁。

>>> s = Student()
>>> s.score = 60 # OK，实际转化为s.set_score(60)
>>> s.score # OK，实际转化为s.get_score()
60
>>> s.score = 9999
Traceback (most recent call last):
 ...
ValueError: score must between 0 ~ 100!

如需了解更多Python相关内容，可参考本站系列教程：《Python数据结构与算法教程》、《Python Socket编程技巧总结》、《Python函数使用技巧总结》、《Python字符串操作技巧汇总》及《Python入门与进阶经典教程》。

希望本文所述内容能对读者的Python程序设计工作有所帮助。