Python @property装饰器：Getter、Setter与Deleter完整解析

Cora

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

原创

本文深入解析Python中@property装饰器的核心原理，通过具体代码示例演示如何将其用于定义getter、setter及deleter方法。文章详细说明了如何利用@property实现无需括号的方法调用，如何结合@xxx.setter实现属性赋值逻辑，以及如何通过@xxx.deleter控制属性删除行为，帮助开发者掌握Python面向对象编程中属性封装的最佳实践。

Python @property装饰器概述

本文重点剖析Python中@property装饰器的底层实现机制，通过详尽的代码示例展示其具体应用方式，旨在为读者的日常学习或项目开发提供具有实际参考价值的技术指南。

实现属性访问（Getter）

引入@property装饰器后，开发者可以直接通过方法名访问该方法，无需在方法名后追加一对小括号“()”，从而简化了调用语法。


class Person:
  def __init__(self, name):
    self.__name = name
  @property
  def say(self):
    return self.__name
xioabai = Person("xiaobai")
#直接通过方法名来访问say方法
print("我的名字是：", xiaobai.say)


我的名字是： xiaobai

在上述代码示例中，通过@property修饰say()方法，使得该方法转化为name属性的getter方法，负责返回内部状态。

实现属性赋值（Setter）

进一步地，可以使用@say.setter装饰器为say方法定义setter逻辑，从而支持对属性的赋值操作。


class Person:
  def __init__(self, name):
    self.__name = name
  @property
  def say(self):
    return self.__name
  @say.setter
  def say(self, value):
    self.__name = value
xiaobai = Person("xiaobai")
xiaobai.say = "xiaohei"
print("我的名字其实是：", xiaobai.say)


我的名字其实是： xiaohei

实现属性删除（Deleter）

此外，利用@say.deleter装饰器可以为say方法定义deleter逻辑，用于指定删除该属性时的具体行为。


class Person:
  def __init__(self, name):
    self.__name = name
  @property
  def say(self):
    return self.__name
  @say.setter
  def say(self, value):
    self.__name = value
  @say.deleter
  def say(self):
    self.__name = "xxx"
xiaobai = Person("xiaobai")
del xiaobai.say
print("我的名字其实是：", xiaobai.say)