@property 用于将方法伪装成属性以保持接口一致，支持只读、可读写及带校验的访问，避免暴露底层数据结构，但不提供访问权限控制。
Python 的 @property 不是用来“控制访问权限”的，而是把方法伪装成属性，让调用更自然，同时还能在取值/赋值时插入逻辑（比如校验、计算、缓存）。它不提供像 Java 那样的 private/public 机制，但能优雅地实现“只读”“可读写”或“带验证的写入”。
为什么用 @property？
直接暴露实例变量（如 obj.age）简单，但一旦需要加校验、日志、单位转换或延迟计算，就得改成方法调用（如 obj.get_age()），破坏原有接口。@property 让你后期加逻辑，却不改调用方式。
- 保持接口一致性：外部仍用
obj.name，内部却可做校验或格式化 - 实现只读属性：只有 getter，没 setter，外界无法修改
- 避免暴露底层数据结构：比如实际存的是
_birth_year，但提供age属性自动算出
@property 的基本写法（只读属性）
用 @property 装饰一个方法，它就变成可读的属性：
class Person:
def __init__(self, birth_year):
self._birth_year = birth_year
<pre class="brush:php;toolbar:false;">@property
def age(self):
from datetime import datetime
return datetime.now().year - self._birth_year
立即学习“Python免费学习笔记（深入）”；
使用：p = Person(1990); print(p.age) —— 看起来是读属性，实际执行了计算逻辑。
加上 setter 实现可读写（带校验）
用同名方法 + @xxx.setter 装饰器，就能支持赋值操作：
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
class Temperature:
def __init__(self, celsius=0):
self._celsius = celsius
<pre class="brush:php;toolbar:false;">@property
def celsius(self):
return self._celsius
@celsius.setter
def celsius(self, value):
if not isinstance(value, (int, float)):
raise TypeError("温度必须是数字")
if value < -273.15:
raise ValueError("不能低于绝对零度")
self._celsius = float(value)
立即学习“Python免费学习笔记（深入）”；
使用：t = Temperature(); t.celsius = 25.5 会触发校验；t.celsius = -300 报错。
可选：加上 deleter 控制删除行为
极少见，但如果你不希望别人用 del obj.attr，可以定义 deleter 并抛异常，或做清理：
@celsius.deleter
def celsius(self):
raise AttributeError("温度值不允许被删除")
这样 del t.celsius 就会报错。
不复杂但容易忽略：@property 方法里别做耗时操作（比如网络请求、大文件读取），否则看似普通属性访问，实际卡住程序。真要延迟加载，建议配合缓存（如 @functools.cached_property，Python 3.8+）。
