在 Python 的對象模型中，屬性訪問與方法調(diào)用共享統(tǒng)一的命名空間，但表達(dá)的語義卻不同：屬性描述對象的狀態(tài)，方法表達(dá)對象的行為。隨著類設(shè)計(jì)的演進(jìn)，原本以屬性公布的值可能需要延遲計(jì)算、加入校驗(yàn)邏輯、動態(tài)生成或與其他屬性保持同步。

如果直接將屬性改寫為方法，不僅破壞既有的 API，還會使調(diào)用方式從：

obj.area

變?yōu)椋?/p>

obj.area()

這種變化違背“接口穩(wěn)定性”原則，不利于代碼維護(hù)。

@property 應(yīng)運(yùn)而生，它可以將無參方法以屬性形式呈現(xiàn)，使訪問簡單直觀，但背后仍由方法控制邏輯，同時兼顧封裝性、可擴(kuò)展性和接口穩(wěn)定性。

一、什么是 @property

@property 是 Python 內(nèi)置的裝飾器，用于將實(shí)例方法轉(zhuǎn)換為描述符對象，使其在訪問時觸發(fā)自定義邏輯。其核心目標(biāo)包括：

（1）提供優(yōu)雅的屬性訪問語法

將方法邏輯以屬性形式暴露，例如 obj.area 而不是 obj.area()。

（2）支持基于方法的動態(tài)計(jì)算或延遲求值

允許在屬性訪問時執(zhí)行邏輯，而無需改變 API 約定。

（3）提升封裝性

通過 getter、setter、deleter 控制屬性的讀取、賦值和刪除行為。

（4）保持 API 的向后兼容

當(dāng)原本的公開屬性需要擴(kuò)展邏輯時，可用 property 保持調(diào)用方式不變。

從 Pythonic 風(fēng)格看，@property 是“顯式優(yōu)于隱晦”的體現(xiàn)：它讓用戶以簡單的語法訪問有邏輯支持的屬性。

二、@property 工作原理

@property 的底層基于。

在 Python 中，任何實(shí)現(xiàn)以下方法之一的對象都被視為描述符：

__get__(self, instance, owner)

__set__(self, instance, value)

__delete__(self, instance)

描述符對象可以控制某個屬性在 讀取、寫入、刪除 時的行為。

property 本質(zhì)是內(nèi)置類：

    def __delete__(self, instance): ...

當(dāng)我們定義：

        return ...

解釋器會將 x 替換為一個 property 實(shí)例，其內(nèi)部維護(hù)三個方法：

? fget：取值邏輯（getter）

? fset：賦值邏輯（setter）

? fdel：刪除邏輯（deleter）

當(dāng)執(zhí)行：

obj.x

實(shí)際等價于：

A.x.__get__(obj, A)

即調(diào)用 fget(obj)。

類似地：

? 賦值 obj.x = value 等價于 A.x.__set__(obj, value)

? 刪除 del obj.x 等價于 A.x.__delete__(obj)

因此，property 與簡單屬性不同，它是具有行為的托管屬性。

三、核心方法：getter/setter/deleter

property 的三個核心組件共同構(gòu)成完整的托管屬性機(jī)制。

（1）getter：屬性讀取邏輯

最基本的 @property 用法是定義只讀屬性。

        return 3.14159 * self.r ** 2

使用：

print(c.area)     # 訪問 area 屬性時會自動調(diào)用其 getter（觸發(fā) fget 方法）

（2）setter：屬性賦值邏輯

setter必須使用與 getter 同名的裝飾器：

p.age = 20      # 訪問 age 屬性時會自動調(diào)用其 setter（觸發(fā) fset 方法）

說明：@age.setter 并不是隨意命名，而是綁定到同一個 property 對象上，因此名稱必須與 getter 相同。

（3）deleter：屬性刪除行為

用于資源釋放或狀態(tài)清理。

del res.conn   # 訪問 conn 屬性時會自動調(diào)用其 deleter（觸發(fā) fdel 方法）

說明：@conn.deleter 綁定的是同名 property 對象的刪除邏輯方法，確保刪除行為受控。

getter、setter 和 deleter 都必須保持與原 property 對象同名，確保訪問行為受控。

四、典型應(yīng)用場景

（1）將計(jì)算邏輯轉(zhuǎn)換為自然的屬性語法

當(dāng)某個值由其他屬性推導(dǎo)而來時，使用 property 會讓 API 更自然。

        return self.w * self.h

用戶角度：

rect.area   # 比 rect.area() 更直觀

這是最常見的用法：用戶訪問屬性時實(shí)際觸發(fā)方法邏輯。

（2）為屬性添加校驗(yàn)邏輯

避免直接暴露內(nèi)部成員。

        self._c = value

（3）保持 API 向后兼容

當(dāng)屬性從簡單值變成計(jì)算值時，不破壞調(diào)用方式。

初始版本中：

obj.speed = 12  # 簡單屬性

后來想加入單位轉(zhuǎn)換或校驗(yàn)：

        self._speed = value

外部代碼無需調(diào)整。

（4）隱藏內(nèi)部實(shí)現(xiàn)，保護(hù)成員命名自由

有了 property 之后，可以隨意修改內(nèi)部成員名（如從 value → _value → _internal_value），讓類具有更好的可維護(hù)性與擴(kuò)展性。

五、常見誤區(qū)

誤區(qū) 1：在 getter 內(nèi)訪問自身屬性導(dǎo)致無限遞歸

錯誤示例：

    return self.x   # 再次訪問 property → 無限遞歸

正確寫法：

    return self._x

誤區(qū) 2：誤認(rèn)為 property 會自動緩存

每次訪問都會重新計(jì)算。

如果需要緩存，應(yīng)使用：

from functools import cached_property

誤區(qū) 3：getter、setter 名稱不一致

在使用 property 時，setter 方法必須綁定到同一個 property 對象上，因此名稱必須與 getter 相同，否則不會生效：

    ...

誤區(qū) 4：將 property 當(dāng)作帶參數(shù)的方法使用

property 只能表現(xiàn)為無參屬性：

obj.value(3) # 錯誤

小結(jié)

@property 基于描述符協(xié)議實(shí)現(xiàn)，是 Python 中用于創(chuàng)建托管屬性的核心機(jī)制。它讓開發(fā)者以屬性語法訪問方法邏輯，在保持接口簡潔的同時獲得計(jì)算、校驗(yàn)與封裝能力。通過 getter、setter 與 deleter，可以設(shè)計(jì)穩(wěn)定且易維護(hù)的類接口。使用 property 時應(yīng)避免遞歸訪問、濫用復(fù)雜邏輯或錯誤綁定 setter，以保持類結(jié)構(gòu)清晰、設(shè)計(jì)合理。

“點(diǎn)贊有美意，贊賞是鼓勵”