@property 是 Python 中一個非常實用的裝飾器，它主要用於將方法轉換為屬性，並提供更優雅的方式來管理類的屬性。
@property 無法「保護」變數，但提供了「控制」變數的機制
從嚴格意義上講，@property 並不能像某些語言（如 Java 或 C++ 的 private 關鍵字）那樣，直接阻止外部程式碼訪問或修改內部變數。Python 的設計哲學是「我們都是成年人」，它更傾向於約定而非強制。當教程說 @property 用來「保護變數」時，他們可能想表達的是：它提供了一種機制，讓您可以在設定（setter）和獲取（getter）變數時，加入額外的邏輯或驗證。這比直接暴露變數要「安全」得多，因為您可以：
- 數據驗證：在設定值之前檢查輸入是否合法。例如，確保年齡為正數，或者字串不為空。
- 計算屬性：屬性值不是直接儲存，而是根據其他屬性計算出來的。
- 副作用：在獲取或設定屬性時觸發其他操作，例如更新資料庫或發送通知。
- 惰性加載：只有在第一次訪問屬性時才計算其值。
考慮一個沒有 @property 的情況：
class Person:
def __init__(self, name, age):
self.name = name
self.age = age
p = Person("小明", 25)
p.age = -10 # 外部可以直接修改為不合法的值
print(p.age)
如果使用 @property：
class Person:
def __init__(self, name, age):
self._name = name # 通常用單下劃線表示內部使用，不建議直接訪問
self.age = age
@property
def age(self):
return self._age
@age.setter
def age(self, new_age):
if not isinstance(new_age, (int, float)) or new_age < 0:
raise ValueError("年齡必須是非負數。")
self._age = new_age
p = Person("小明", 25)
# p.age = -10 # 這行會觸發 ValueError
print(p.age)
p.age = 30 # 可以正常設定
在這個例子中，@property 使得對 age 屬性的賦值操作會經過 age.setter 方法的驗證，從而「保護」了 _age 這個內部變數不被賦予不合法的值。所以，與其說「保護」，不如說它提供了更細膩的「控制」能力。
@property 的好處：實現屬性訪問控制，同時保持語法簡潔
@property 和其配套的 @<property_name>.setter 裝飾器主要有以下幾個好處：
- 保持介面一致性：允許您在不改變外部程式碼調用方式（仍然是
instance.attribute）的情況下，在後台實現複雜的邏輯。 - 無需修改已有程式碼：如果您的類最初是直接暴露公共屬性，後來需要為這些屬性添加驗證或其他邏輯，您可以使用
@property將其轉換為方法，而不需要修改所有使用這些屬性的外部程式碼。對外部來說，它看起來仍然是一個普通的屬性。 - 封裝和抽象：將內部實現細節隱藏起來。使用者不需要知道
age實際上是一個方法在處理，他們只需要像訪問普通屬性一樣去使用它。 - 可讀性與簡潔性：讓程式碼更清晰易懂。
- 替代傳統 getter/setter 方法：在沒有
@property之前，我們可能會寫成這樣：
class Person:
def __init__(self, name):
self._name = name
def get_name(self):
return self._name
def set_name(self, new_name):
self._name = new_name
p = Person("小華")
print(p.get_name())
p.set_name("小華2")
有了 @property，您可以這樣寫：
class Person:
def __init__(self, name):
self._name = name
@property
def name(self):
return self._name
@name.setter
def name(self, new_name):
self._name = new_name
p = Person("小華")
print(p.name) # 像訪問屬性一樣
p.name = "小華2" # 像設定屬性一樣
顯然，第二種方式的語法更簡潔，也更符合 Python 的風格。
Pythonic 設計：@property 是 Python 中實現「屬性」（Attribute）的一種標準且優雅的方式。它讓您能夠在保持程式碼簡潔性的同時，對屬性進行更細緻的控制。
總結來說，@property 雖然不能強制性地「保護」變數（因為 Python 允許直接訪問帶下劃線的變數），但它提供了一種強大而優雅的機制，讓您可以在不改變外部調用語法的前提下，為類的屬性添加讀取、寫入或刪除時的自定義邏輯，從而更好地控制和管理資料。這對於建立健壯、易於維護的程式碼非常重要。
