直接用@property定义setter会报错，因为只定义getter时属性默认只读，赋值会抛AttributeError；setter需显式用@xxx.setter装饰且方法名、参数须匹配。
为什么直接用@property定义setter会报错
当你只写 @property 装饰器定义 getter，却没配对定义 setter，Python 会把该属性视为只读。此时若尝试赋值（比如 obj.name = "Alice"），就会抛出 AttributeError: can't set attribute。
根本原因：setter 是独立的装饰器，必须显式声明，不能靠 getter 自动推导。
实操建议：
- 要支持赋值，必须额外写一个同名方法，并用
@xxx.setter装饰 - setter 方法名必须和 getter 完全一致（包括大小写）
- setter 方法只能接受两个参数：
self和新值（比如value）
@property + @xxx.setter 的最小可用写法
下面是最简但可运行的完整结构，注意命名一致性与参数数量：
class Person:
def __init__(self, name):
self._name = name
<pre class="brush:php;toolbar:false;">@property
def name(self):
return self._name
@name.setter
def name(self, value):
if not isinstance(value, str) or not value.strip():
raise ValueError("name must be a non-empty string")
self._name = value.strip()
关键点：
- 内部用
_name存储实际值，避免和属性名冲突导致无限递归 - setter 中做了校验，这是直接操作私有变量做不到的“自动守门”效果
- 调用时完全像普通属性：
p = Person(" Bob "); print(p.name) # " Bob "; p.name = "Tom" # 触发 setter
getter/setter里访问属性本身会怎样
如果在 @property 方法里又写 self.name，或在 @name.setter 里写 self.name = ...，会触发无限递归，最终爆 RecursionError。
这是新手最常踩的坑——误把属性名当变量名用。
正确做法始终是操作带下划线的底层变量（如 self._name），而不是属性名本身。
例外情况：需要链式逻辑（比如 setter 更新后自动触发另一个属性计算），也应通过其他明确方法或私有方法完成，不推荐在 setter 里再读写自身属性。
什么时候不该用@property而该用普通方法
如果操作明显有副作用、耗时较长、或语义上不是“获取/设置状态”，就别硬套 @property。
典型反例：
- 从网络加载数据：
@property让人误以为是轻量访问，实际可能卡住主线程 - 触发文件写入或数据库更新：这类动作应该用
save()、export_to(...)等动词命名的方法 - 计算开销大且结果不缓存：每次访问都重算，不如显式调用
get_full_report()
Python 的约定是：property 应该表现得像字段一样快、无副作用、幂等；否则就是设计信号——该换方法了。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
