在 Python 的對象模型中，方法通常依賴實例（通過 self）訪問對象狀態(tài)。然而，有些方法需要訪問類本身而非特定實例的狀態(tài)，例如創(chuàng)建實例的工廠方法、修改類級屬性或管理類共享資源。

@classmethod裝飾器正是為這種場景設(shè)計的：它將方法綁定到類，而非實例，使方法在調(diào)用時自動接收類對象作為第一個參數(shù)。

一、什么是 @classmethod

@classmethod 是 Python 內(nèi)置的裝飾器，用于將函數(shù)聲明為類方法，使其自動接收類對象 cls 作為第一個參數(shù)。

類方法具有以下特點：

（1）接收類對象

第一個參數(shù)約定為 cls，代表調(diào)用時的類。

（2）可通過類或?qū)嵗{(diào)用

既可以用 ClassName.method() 調(diào)用，也可以通過實例 instance.method() 調(diào)用。兩者傳入的第一個參數(shù)都是類對象。

（3）適合類級操作

如訪問/修改類屬性、實現(xiàn)工廠方法或管理類共享資源。

二、工作原理

在 Python 中，定義在類體內(nèi)的函數(shù)會被存儲為類屬性，依然是函數(shù)對象本身。@classmethod 會把這個函數(shù)包裝為 classmethod 對象，該對象實現(xiàn)了的 __get__ 方法，從而在屬性訪問時返回一個綁定到類的可調(diào)用對象。

簡化示例如下：

        return bound_classmethod

? __get__(self, instance, owner) 中的 owner 通常是屬性被訪問時的類（例如直接通過類訪問，或通過實例訪問時的實例所屬類或子類）。因此 cls 會指向調(diào)用時的類（支持繼承與多態(tài)）。

? 類方法內(nèi)部可以通過 cls 訪問類屬性、調(diào)用其他類方法或創(chuàng)建類的新實例（cls(...)），這使得它們常被用作替代構(gòu)造器。

三、基本用法

（1）定義類方法

        return cls(1)

（2）調(diào)用類方法

print(c2.radius)             # 輸出：5

提示：

當在子類中調(diào)用類方法時，cls 會指向子類，從而支持繼承時的工廠方法多態(tài)性。

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

（1）工廠方法（替代構(gòu)造器）

print(p.name, p.age)    # 小艾 18

（2）訪問或修改類屬性

print(Account.interest_rate)  # 0.08

（3）類級邏輯封裝（組織命名空間）

print(Logger.logs)  # ['System started']

五、與其他方法對比

實例方法、類方法以及靜態(tài)方法的簡要比較：

方法類型

第一個參數(shù)

是否能訪問實例

是否能訪問類

實例方法

normal

self

可通過 self

類方法

@classmethod

cls

靜態(tài)方法

@staticmethod

（除非顯示訪問類）

? 實例方法：用于訪問或修改實例狀態(tài)。

? 類方法：用于訪問或修改類狀態(tài)、替代構(gòu)造器或類級邏輯。通過繼承調(diào)用時，cls 會綁定到子類，從而實現(xiàn)多態(tài)性（重要）。

? 靜態(tài)方法：語義上是類命名空間內(nèi)的普通函數(shù)，不自動接收 self 或 cls。適合將工具函數(shù)組織到類中，但不需要訪問類/實例狀態(tài)。

六、常見誤區(qū)

誤區(qū) 1：誤以為 cls 是實例

        print(cls)  # 輸出類對象（例如 ），而非實例

誤區(qū) 2：在類方法中訪問實例狀態(tài)

類方法沒有 self，因此不應(yīng)依賴實例屬性。若需要實例數(shù)據(jù)，應(yīng)使用實例方法或接收顯式實例參數(shù)。

誤區(qū) 3：與靜態(tài)方法混淆

靜態(tài)方法沒有 cls，因此無法直接訪問類屬性或調(diào)用類方法。若函數(shù)需要訪問類或支持繼承時的多態(tài)，請使用類方法。

七、實踐建議

（1）當在子類上調(diào)用類方法時，cls 會指向子類。這使得類方法非常適合實現(xiàn)可被繼承并在子類中正確構(gòu)造子類實例的工廠方法。

    print(f"motorcycle 類型: {type(motorcycle).__name__}")  # 輸出: Motorcycle

編寫單元測試以驗證在子類上調(diào)用類方法是否如預(yù)期返回子類實例。

（2）修改類屬性（例如在類方法中）會影響該類及其未覆蓋該屬性的子類。在并發(fā)環(huán)境下需要考慮同步（例如使用鎖）以避免競態(tài)條件。

（3）若方法確實與類概念相關(guān)且需要訪問類級別上下文，使用 @classmethod；僅為組織命名空間而不需要類上下文時，優(yōu)先考慮 @staticmethod 或模塊級函數(shù)。

（4）若類狀態(tài)復(fù)雜且多線程訪問頻繁，考慮使用實例封裝或外部同步機制。

（5）類方法在元編程中也有用途（如為類注冊、初始化類級資源等），但元類邏輯復(fù)雜，使用時保持謹慎并寫清晰注釋。

小結(jié)

@classmethod 將函數(shù)轉(zhuǎn)換為類方法，使其自動接收調(diào)用時的類對象 cls。它適用于替代構(gòu)造器、類級狀態(tài)管理與與類概念相關(guān)的邏輯組織。類方法在繼承時保持多態(tài)性（cls 指向子類），但不能訪問實例狀態(tài)。合理搭配實例方法與靜態(tài)方法，可構(gòu)建清晰、可繼承且維護良好的類接口。

“點贊有美意，贊賞是鼓勵”