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

fget 是获取属性值的函数。 fset 是用于设置属性值的函数。 fdel 是用于删除属性值的函数。并且 doc 为属性对象创建文档字符串。 property 函数是 Python 面向对象编程中一个非常重要的机制，它允许你以访问 属性 的方式来操作 方法，从而实现 属性的托管（Managed Attributes）。 property 函数的作用是 将一个类的普通方法（getter、setter、deleter）“封装”或“绑定”到一个属性名上。这样，当你访问、修改或删除这个属性时，实际上执行的是你指定的方法，而不是直接操作实例的字典（__dict__）。 class C: def __init__(self): self._x = None def getx(self): return self._x def setx(self, value): self._x = value def delx(self): del self._x x = property(getx, setx, delx, "I'm the 'x' property.") 如果 c 为 C 的实例，c.x 将调用 getter，c.x = value 将调用 setter， del c.x 将调用 deleter。你可以在不改变外部调用接口（保持 c.x 的形式）的情况下，在幕后默默地添加复杂的逻辑，实现了良好的 封装。 1. 只读属性（@property）@property 装饰器用于修饰 getter 方法，将其转换为一个 只读属性。 class Parrot: def __init__(self): self._voltage = 100000 @property def voltage(self): """Get the current voltage.""" return self._voltage @property 装饰器会将 voltage() 方法转化为一个具有相同名称的只读属性 "getter"，并将 voltage 的文档字符串设为 "Get the current voltage." 当你使用parrot.voltage 会执行 voltage() 方法。尝试设置 parrot.voltage = value 会报错，因为它没有定义 setter。 2. 可读写属性（@property + @setter）要创建一个完整的可读写属性，你需要先用 @property 装饰 getter，然后使用 特征属性对象（这里是 x）的 .setter 和 .deleter 方法来装饰相应的方法 class C: # 1. 定义 Getter 并创建 property 对象 x @property def x(self): """I'm the 'x' property.""" return self._x # 2. 使用 x.setter 装饰器定义 Setter # ⚠️ 注意：方法名必须与属性名 (x) 相同 @x.setter def x(self, value): # 可以在这里添加逻辑，如类型检查 self._x = value # 3. 使用 x.deleter 装饰器定义 Deleter @x.deleter def x(self): del self._x 这种装饰器写法 与第一个例子（函数传入）是完全等价的，但结构更清晰，更常用于现代 Python 代码中。 3.懒加载/延迟计算（Lazy Loading） class AppConfig: @property def settings(self): # 只有第一次访问 self.settings 时才会执行下面的逻辑 if not hasattr(self, '_settings'): print("正在加载配置文件...") # 假设这是耗时的文件读取操作 self._settings = {"timeout": 30, "log_level": "DEBUG"} return self._settings config = AppConfig() # 第一次访问：触发加载 设置self._settings属性 print(config.settings['timeout']) # 第二次访问：直接返回已存储的值，不再重新加载 print(config.settings['log_level']) 4.迁移和重构（Refactoring） # 早期版本 class User: def __init__(self, email): self.email = email # 公共属性，直接存储 user = User("test@example.com") print(user.email) # 外部代码直接访问 # 后续新增：必须对 email 进行格式验证和规范化，以确保数据的质量。 class User: def init(self, email): # 初始化时调用 setter，确保初始值也被验证 self.email = email # --- Getter (提供只读访问) --- @property def email(self): """外部代码访问 user.email 时，实际执行此方法""" return self._email # --- Setter (引入验证和新逻辑) --- @email.setter def email(self, new_email): # 1. 新增逻辑：数据验证 (例如，确保包含 '@') if "@" not in new_email: raise ValueError("Email 地址格式不正确，必须包含 @ 符号。") # 2. 新增逻辑：数据清洗/规范化 (例如，全部转为小写) validated_email = new_email.lower() # 3. 存储到私有属性 self._email = validated_email print(f"✅ Email 已更新并验证：{self._email}") # --- 外部代码调用（无需修改） --- user = User("Test@Example.com") # ✅ Email 已更新并验证：test@example.com # 外部代码仍使用 user.email 访问和赋值 print(f"获取 Email: {user.email}") # 输出：test@example.com # 尝试非法赋值 try: user.email = "invalidemail" except ValueError as e: print(f"❌ 错误捕获：{e}") # 错误捕获：Email 地址格式不正确...