@property 默认只提供 getter，不定义 setter 时赋值会直接报 AttributeError；要拦截赋值必须显式定义同名 @xxx.setter 方法。
为什么直接用 @property 无法拦截赋值？
很多人以为加了 @property 就能像 JavaScript 的 getter/setter 那样自动拦截所有访问，其实不是。@property 只提供读取控制（即 getter），不定义 setter 时，尝试给属性赋值会直接报 AttributeError: can't set attribute —— 它根本没进入你的逻辑，而是被 Python 属性协议拦在门外。
真正要实现“拦截”，必须显式定义 setter 方法，且名字和 getter 一致：
class User:
def __init__(self, name):
self._name = name
<pre class="brush:php;toolbar:false;">@property
def name(self):
print("getting name")
return self._name
@name.setter
def name(self, value):
print("setting name to", repr(value))
if not isinstance(value, str) or not value.strip():
raise ValueError("name must be non-empty string")
self._name = value.strip()
- setter 方法名必须和 property 名完全一致（这里是
name） - setter 接收两个参数：
self和新值（不能叫value以外的名字？可以，但语义上建议用value） - 没写
@name.setter→ 赋值直接失败，不走任何你写的代码
如何用 @property 拦截并缓存计算属性？
常见需求是：属性值依赖其他字段、开销大、又不想每次访问都重算。这时候 @property 是天然选择，但要注意缓存时机和线程安全边界。
立即学习“Python免费学习笔记（深入）”；
比如一个用户对象要返回全名，但姓和名可能随时变：
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
class User:
def __init__(self, first_name, last_name):
self.first_name = first_name
self.last_name = last_name
self._full_name = None # 缓存标记
<pre class="brush:php;toolbar:false;">@property
def full_name(self):
if self._full_name is None:
self._full_name = f"{self.first_name} {self.last_name}".strip()
return self._full_name
@full_name.setter
def full_name(self, value):
# 拦截赋值：拆解并更新底层字段
parts = value.split(maxsplit=1)
self.first_name = parts[0] if parts else ""
self.last_name = parts[1] if len(parts) > 1 else ""
self._full_name = value # 同步缓存
- 缓存放在实例变量（如
_full_name）里，不是类变量，避免多实例污染 - setter 中手动维护缓存一致性，否则下次 get 仍返回旧值
- Python 3.10 没内置线程安全的 property 缓存，高并发场景需加
threading.Lock或改用functools.cached_property（但注意它只支持只读）
为什么 cached_property 不能替代 @property 实现可写拦截？
functools.cached_property 在 Python 3.8+ 引入，3.10 完全可用，但它设计目标是“只读 + 缓存”，一旦计算完成，就变成普通实例属性，后续赋值不会触发 setter，也不会报错 —— 它直接绕过了 property 协议。
看这个反例：
from functools import cached_property
<p>class ExpensiveData:
def <strong>init</strong>(self, source):
self.source = source</p><pre class="brush:php;toolbar:false;">@cached_property
def processed(self):
print("running heavy computation...")
return self.source.upper()下面这行不会调用任何 setter，也不会报错，而是直接覆盖 cached_property 生成的实例属性
obj = ExpensiveData("hello") print(obj.processed) # 输出 "running heavy computation..." 和 "HELLO" obj.processed = "MANUAL" # ✅ 成功，但你的逻辑完全没执行 print(obj.processed) # 输出 "MANUAL"，不再是 upper 结果
-
cached_property本质是 descriptor，但只实现__get__，不实现__set__ - 一旦被赋值，Python 就把结果存进
obj.__dict__，后续访问走字典查找，跳过 descriptor - 需要可写拦截？只能回到原生
@property+ 手动 setter
在继承链中重写 @property 时容易踩什么坑？
子类想扩展父类的 property 行为（比如增加校验或日志），最稳妥方式是显式调用父类 getter/setter，而不是直接读写底层变量 —— 因为底层变量名可能不公开，或父类未来会改实现。
class Parent:
def __init__(self, value):
self._value = value
<pre class="brush:php;toolbar:false;">@property
def value(self):
return self._value
@value.setter
def value(self, v):
self._value = vclass Child(Parent): @property def value(self): print("Child getting value") return super().value # ✅ 调用父类 getter
@value.setter
def value(self, v):
print("Child setting value")
if v < 0:
raise ValueError("Child forbids negative values")
super().value = v # ✅ 调用父类 setter
- 别在子类 setter 里直接操作
self._value，万一父类哪天改成用self.__value或加密存储，你就崩了 - 如果父类没定义 setter，子类也不能定义同名 setter —— Python 会报
TypeError: Cannot overwrite final property（实际是 AttributeError，但行为等效） - 用
super().xxx而不是Parent.xxx.fset(self, v)，后者耦合太强，且在多重继承中易出错
property 拦截的关键不在语法有多炫，而在你是否清楚每次访问走的是哪条路径：是 descriptor 的 __get__，还是实例字典的键查找，抑或父类方法委托。漏掉 setter、误用 cached_property、绕过 super 调用，都是线上静默失效的常见源头。
