在 Python 中,一切皆對象,類也是對象,其類型是 type。type(name, bases, namespace) 是動態創建類的構造函數,也是元類 __new__ 的標準簽名。
| 參數 | 類型 | 含義 | 示例值 |
|---|---|---|---|
cls | type (或子類) | 元類本身,即調用 __new__ 的類 | <class '__main__.ModelMetaClass'> |
name | str | 要創建的類名 | 'Model' |
bases | tuple | 基類元組 (繼承鏈) | (<class 'dict'>,) |
namespace | dict | 類命名空間:屬性、方法、註解、__module__ 等 | {'__module__': '__main__', '__metaclass__': ..., '__init__': ...} |
import logging
logging.basicConfig(level=logging.INFO, format='%(message)s')
class ModelMetaClass(type):
def __new__(cls, name, bases, namespace):
# 1. 記錄元類信息
logging.info(f"cls is: {cls}") #
logging.info(f"name is: {name}") # Model
logging.info(f"bases is: {bases}") # (,)
logging.info(f"namespace is: {namespace}") # {'__module__': '__main__', ...}
# 2. 可在此修改 namespace:自動添加字段、驗證、註冊等
# namespace['_created_at'] = time.time()
# 3. 必須調用父類 __new__ 完成類創建
return super().__new__(cls, name, bases, namespace)
class Model(dict, metaclass=ModelMetaClass):
"""使用 ModelMetaClass 作為元類"""
def __init__(self):
super().__init__()
# 觸發元類 __new__
m = Model()
print("實例創建完成:", m)
cls is:
name is: Model
bases is: (,)
namespace is: {'__module__': '__main__', '__metaclass__': , '__init__': }
實例創建完成: {}
cls:元類自身,用於鏈式調用 super().__new__。name:類定義時的名稱 class Model。bases:繼承的基類元組,此處繼承 dict。namespace:類體內定義的所有內容,包含隱式添加的 __module__、__qualname__、__metaclass__ (Python 2 風格,Py3 忽略) 等。class Field: pass
class ModelMeta(type):
def __new__(cls, name, bases, namespace):
fields = {k: v for k, v in namespace.items() if isinstance(v, Field)}
namespace['_fields'] = fields
return super().__new__(cls, name, bases, namespace)
class User(metaclass=ModelMeta):
id = Field()
name = Field()
email = Field()
print(User._fields) # {'id': , 'name': , 'email': }
class SingletonMeta(type):
_instances = {}
def __call__(cls, *args, **kwargs):
if cls not in cls._instances:
cls._instances[cls] = super().__call__(*args, **kwargs)
return cls._instances[cls]
class Config(metaclass=SingletonMeta):
pass
assert Config() is Config()
class AbstractMeta(type):
def __new__(cls, name, bases, namespace):
new_class = super().__new__(cls, name, bases, namespace)
# 檢查抽象方法是否實現
for method in getattr(new_class, '__abstractmethods__', set()):
if not hasattr(new_class, method):
raise TypeError(f"Can't instantiate abstract class {name} with abstract method {method}")
return new_class
| 階段 | __new__ | __init__ |
|---|---|---|
| 調用時機 | 創建類對象時 (定義類時) | 類對象創建後,實例化前 |
| 返回值 | 必須返回創建的類對象 | 必須返回 None |
| 典型用途 | 修改類結構、註冊、驗證、單例控制 | 初始化類屬性、註冊信號 |
| 參數 | (cls, name, bases, namespace) | (cls, *args, **kwargs) |
__init_subclass__ (Python 3.6+) 更簡單清晰。__new__(cls, name, bases, namespace, **kwargs) 接收額外關鍵字參數 (如 metaclass=... 以外的參數)。type.__new__(cls, name, bases, namespace) 是 Python 類創建的核心入口。理解四個參數含義,掌握在 __new__ 中操作 namespace 實現類結構自定義,是掌握 Python 元編程的關鍵。實際項目中優先考慮 __init_subclass__、裝飾器、數據類等輕量級方案,元類作為終極手段用於框架級基礎設施構建。