??Python 中的 @property 特性詳解??

@property 是 Python 中用于??將方法轉換為屬性??的裝飾器，它允許開發者以訪問屬性的方式調用方法，同時可以添加邏輯控制（如數據校驗、計算屬性等）。以下是其核心用法和優勢：

---

??一、@property 的基本用法??

??1. 將方法變為只讀屬性??

class Circle:def __init__(self, radius):self.radius = radius@propertydef area(self):  # 通過方法計算面積，但調用時像屬性return 3.14 * self.radius ** 2c = Circle(5)
print(c.area)  # 78.5（無需括號，像訪問屬性）
# c.area = 100  # 報錯！area是只讀屬性

??2. 添加 setter 和 deleter??

通過 @屬性名.setter 和 @屬性名.deleter 控制屬性的寫入和刪除：

class Temperature:def __init__(self, celsius):self._celsius = celsius  # 內部存儲攝氏度@propertydef celsius(self):  # 讀操作return self._celsius@celsius.setterdef celsius(self, value):  # 寫操作（可校驗）if value < -273.15:raise ValueError("溫度不能低于絕對零度")self._celsius = value@propertydef fahrenheit(self):  # 計算屬性（華氏度）return self._celsius * 9/5 + 32temp = Temperature(25)
print(temp.fahrenheit)  # 77.0（自動計算）
temp.celsius = 30       # 通過 setter 修改
# temp.celsius = -300    # 觸發 ValueError

---

??二、@property 的核心優勢??

??1. 數據校驗??

在 setter 中限制屬性值的合法性：

class User:def __init__(self, name):self._name = name@propertydef name(self):return self._name@name.setterdef name(self, value):if not isinstance(value, str):raise TypeError("姓名必須是字符串")self._name = valueuser = User("Alice")
user.name = "Bob"  # 合法
# user.name = 123   # 報錯：TypeError

??2. 計算屬性??

動態生成屬性值（如面積、平均值）：

class Rectangle:def __init__(self, width, height):self.width = widthself.height = height@propertydef area(self):return self.width * self.heightrect = Rectangle(3, 4)
print(rect.area)  # 12（自動計算）

??3. 兼容性??

在不改變外部接口的情況下修改內部實現：

class OldClass:def __init__(self, value):self.value = value  # 直接暴露屬性# 改為使用 @property 后，外部代碼無需修改
class NewClass:def __init__(self, value):self._value = value@propertydef value(self):return self._value * 2  # 內部邏輯變化

---

??三、@property 與普通方法的區別??

??特性??	??@property??	??普通方法??
??調用方式??	obj.property（無括號）	obj.method()（需括號）
??功能??	像屬性一樣訪問，但可包含邏輯	顯式執行操作
??可寫性??	需配合 setter 才能修改	可直接修改返回值

---

??四、實際應用場景??

??1. 數據模型（如 Django ORM）??

class Product:def __init__(self, price):self._price = price@propertydef price_with_tax(self):return self._price * 1.1  # 自動計算含稅價格

??2. API 設計??

隱藏內部字段名，提供統一接口：

class APIResponse:def __init__(self, raw_data):self._raw_data = raw_data@propertydef data(self):return self._raw_data["data"]  # 封裝原始數據解析

??3. 兼容舊代碼??

逐步替換直接暴露的屬性：

class LegacyClass:def __init__(self, x):self.x = x  # 舊代碼直接訪問 x# 新代碼改用 @property
class ModernClass:def __init__(self, x):self._x = x@propertydef x(self):return self._x ** 2  # 新增邏輯

---

??五、總結??

??要點??	??說明??
??基本功能??	將方法偽裝成屬性，保持調用簡潔性
??核心方法??	@property（讀）、@attr.setter（寫）、@attr.deleter（刪）
??優勢??	數據校驗、計算屬性、接口兼容性
??適用場景??	需要控制屬性訪問或動態計算的場景

??核心價值??：
??以屬性的語法實現方法的功能??，兼顧簡潔性與靈活性。