Python中@property装饰器与property函数的完整用法解析

Ada

发布时间：2026-10-13 | 4人浏览过

原创

本文详细解析Python中@property装饰器及property函数的常见用法。通过基本属性访问、setter/deleter定义、实际价格计算示例以及私有属性封装等场景，展示如何实现类属性的智能读写控制。内容涵盖代码实现与运行结果，帮助开发者深入理解Python属性机制。

Python属性访问机制概述

本文通过具体实例，详细介绍Python中@property装饰器以及property函数的典型应用场景。以下内容旨在为读者提供参考与学习素材。

@property装饰器的基本使用

首先介绍@property的基本用法，其主要功能是将类中的方法转换为属性进行访问。


class Person(object):
  @property
  def get_name(self):
    print('我叫xxx')
def main():
  person = Person()
  person.get_name
if __name__ == '__main__':
  main()

代码执行后的输出结果如下：

我叫xxx

定义属性的setter与deleter

接下来演示@property装饰器中setter和deleter方法的定义与使用。


class Goods(object):
  @property
  def price(self):
    print('@property')
  @price.setter
  def price(self,value):
    print('@price.setter:'+str(value))
  @price.deleter
  def price(self):
    print('@price.deleter')
obj = Goods()
obj.price = 50
obj.price
del obj.price

@property综合应用示例

进一步通过一个完整的@property示例进行说明。


class Goods(object):
  def __init__(self):
    #原价
    self.original_price = 100
    #折扣
    self.discount = 0.8
  @property
  def price(self):
    #实际价格=原价*折扣
    new_price = self.original_price*self.discount
    return new_price
  @price.setter
  def price(self,value):
    self.original_price = value
  @price.deleter
  def price(self):
    del self.original_price
obj = Goods()
obj.price
obj.price = 200
del obj.price

使用property函数实现属性控制

随后介绍如何使用property函数来实现相同的功能。


class Foo(object):
  def get_name(self):
    print('get_name')
    return 'laowang'
  def set_name(self, value):
    '''必须两个参数'''
    print('set_name')
    return 'set value' + value
  def del_name(self):
    print('del_name')
    return 'laowang'
  NAME = property(get_name, set_name, del_name, 'description.')
obj = Foo()
obj.NAME  #调用get方法
obj.NAME = 'alex'  #调用set方法
desc = Foo.NAME.__doc__   #调用第四个描述
print(desc)
del obj.NAME  #调用第三个删除方法

该段代码的执行结果如下：

get_name set_name description. del_name

property处理私有属性

最后，展示如何利用property函数来操作私有属性的getter和setter方法。


class Person(object):
  def __init__(self, age):
    self.__age = age
  def set_age(self, value):
    self.__age = value
  def get_age(self):
    return self.__age
  AGE = property(get_age, set_age)
person = Person(15)
person.AGE = 20
print(str(person.AGE))

运行结果如下：