1. 基础回顾

property 可以让你把方法伪装成属性：

class Circle:

def __init__(self, radius):

self._radius = radius

@property

def radius(self):

print("Getting radius")

return self._radius

@radius.setter

def radius(self, value):

print("Setting radius")

self._radius = value

@property

def area(self):

return 3.1415 * self._radius ** 2

c = Circle(5)

print(c.radius) # 调用 getter

c.radius = 10 # 调用 setter

print(c.area) # 只读属性

特点：

@property 装饰方法 → 可读属性

@<prop>.setter → 可写属性

@<prop>.deleter → 可删除属性

2. 边缘问题

2.1 动态属性依赖内部状态未初始化

class Foo:

@property

def x(self):

return self._x + 1

f = Foo()

print(f.x) # AttributeError: 'Foo' object has no attribute '_x'

⚠️ 原因：_x 尚未初始化，但 property 每次访问都会执行方法。

✅ 解决：在 __init__ 中初始化 _x，或者用 getattr 提供默认值：

@property

def x(self):

return getattr(self, "_x", 0) + 1

2.2 与 __dict__ 冲突

动态属性不会自动写入实例 __dict__，可能导致意外行为：

class Bar:

@property

def y(self):

return 42

b = Bar()

print(b.__dict__) # {}

b.y = 99 # AttributeError: can't set attribute

property 控制读写，不在 __dict__ 中存储值

如果 setter 没有正确保存，会导致属性看起来可以设置但实际丢失。

✅ 解决：setter 内部保存值：

@x.setter

def x(self, value):

self._x = value

2.3 动态属性依赖其他动态属性

class Foo:

@property

def a(self):

return self.b + 1

@property

def b(self):

return self.a + 1

f = Foo()

print(f.a) # RecursionError: maximum recursion depth exceeded

⚠️ 原因：a 调用 b，b 又调用 a，无限递归

✅ 解决：不要让 property 直接依赖其他 property，或者用缓存/内部状态避免递归。

2.4 property 在类方法或静态方法中不生效

class Foo:

@staticmethod

@property

def x():

return 42

⚠️ 原因：@staticmethod 与 @property 顺序不对

✅ 修正：property 只能用在实例方法上，静态属性请用类属性或 @classmethod + @property：

class Foo:

_value = 42

@classmethod

@property

def x(cls):

return cls._value

2.5 动态属性与继承

class Base:

@property

def value(self):

return 1

class Sub(Base):

value = 2

s = Sub()

print(s.value) # 2，覆盖了 property

⚠️ 原因：子类可以用普通属性覆盖父类 property

✅ 解决：如果希望继承 property，可在子类用 @property 重写，或者不要直接赋值给同名属性。

2.6 property 性能问题

每次访问 property 都会执行函数

如果计算复杂，频繁访问可能成为性能瓶颈

✅ 解决方案：

使用缓存（functools.lru_cache 或内部缓存 _cached_value）

或者用 @cached_property（Python 3.8+）

from functools import cached_property

class Expensive:

@cached_property

def value(self):

print("Computing...")

return sum(range(1000000))

e = Expensive()

print(e.value) # 第一次计算

print(e.value) # 直接返回缓存

2.7 删除 property

class Foo:

@property

def x(self):

return 42

f = Foo()

del f.x # AttributeError: can't delete attribute

必须实现 @x.deleter 才能删除，否则默认不可删除

@x.deleter

def x(self):

del self._x

3. 总结

问题类型描述建议

未初始化依赖 property 访问内部变量未初始化 __init__ 初始化，或 getattr 默认值

__dict__ 冲突 property 不存储值，直接赋值报错 setter 内部保存值

无限递归 property 依赖其他 property 避免循环调用，使用内部缓存

静态/类方法 @property 与 @staticmethod 冲突静态属性用类属性或 @classmethod + @property

子类覆盖子类赋值覆盖父类 property 子类用 property 重写，避免同名普通属性

性能问题 property 每次访问都计算使用 cached_property 或内部缓存

删除限制默认不可删除实现 @<prop>.deleter

ITPub博客

使用 property 创建动态属性时的边缘问题

最新文章