萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python 類靜態變量實現共享隊列:類屬性 vs 實例屬性差異解析

Python 類屬性 (定義在類體內) 由所有實例共享,可作為「靜態變量」實現跨實例資料共享 (如隊列、計數器、快取)。本文對比類屬性與實例屬性行為,示範共享隊列正確寫法與常見陷阱。

核心概念:類屬性 vs 實例屬性

class CaptchaImage:
    # 類屬性 (靜態變量) - 所有實例共享
    _queue = []
    
    def __init__(self):
        # 實例屬性 - 每個實例獨有
        self.instance_data = []
    
    def queue(self):
        return self._queue  # 存取類屬性
    
    def insert_code(self, code):
        self._queue.append(code)  # 修改共享列表

# 測試
c1 = CaptchaImage()
c1.insert_code(1)
c2 = CaptchaImage()
c2.insert_code(2)

print(c1.queue())  # [1, 2] - 共享!
print(c2.queue())  # [1, 2] - 同一列表
print(c1.queue() is c2.queue())  # True

常見陷阱:可變預設參數

# 錯誤寫法:預設參數在定義時求值,所有呼叫共享同一列表
def bad_queue(self, arr=[]):
    return arr

# 正確寫法:用 None 做哨兵
def good_queue(self, arr=None):
    if arr is None:
        arr = []
    return arr

正確實現共享隊列的三種模式

模式 1:類屬性列表 (最簡單)

class SharedQueue:
    _items = []  # 類屬性
    
    @classmethod
    def push(cls, item):
        cls._items.append(item)
    
    @classmethod
    def pop(cls):
        return cls._items.pop(0) if cls._items else None
    
    @classmethod
    def all(cls):
        return list(cls._items)  # 回傳副本防外部修改

模式 2:模組級全域變量 (更 Pythonic)

# queue_module.py
from collections import deque
_queue = deque(maxlen=1000)  # 固定大小防記憶體洩漏

def push(item): _queue.append(item)
def pop(): return _queue.popleft() if _queue else None
def all(): return list(_queue)

模式 3:單例模式封裝

class QueueSingleton:
    _instance = None
    _items = []
    
    def __new__(cls):
        if cls._instance is None:
            cls._instance = super().__new__(cls)
        return cls._instance
    
    def push(self, item): self._items.append(item)
    def pop(self): return self._items.pop(0) if self._items else None

執行緒安全版 (threading.Lock)

import threading

class ThreadSafeQueue:
    _items = []
    _lock = threading.Lock()
    
    @classmethod
    def push(cls, item):
        with cls._lock:
            cls._items.append(item)
    
    @classmethod
    def pop(cls):
        with cls._lock:
            return cls._items.pop(0) if cls._items else None

何時使用類屬性 (靜態變量)

  • ✅ 計數器、快取、配置、註冊表、共享資源池。
  • ❌ 實例專屬狀態 (姓名、ID、狀態) 必須用實例屬性 self.xxx。
  • ⚠️ 可變類屬性 (列表、字典) 修改會影響所有實例,需謹慎設計。

總結

Python 無 static 關鍵字,類屬性即靜態變量。定義在 class 區塊、__init__ 外部的變量為類屬性,透過 ClassName.attr 或 self.__class__.attr 存取。善用類方法 (@classmethod) 操作類屬性,提升可讀性與繼承相容性。

copyright © 萬盛學電腦網 all rights reserved