Python dict.clear() 方法詳解：就地清空字典、O(1) 操作、與重新賦值 {} 差異對照

dict.clear() 將字典就地清空，移除所有鍵值對，保留字典物件身分。不同於重新賦值 d = {} (建立新物件)，clear() 影響所有指向該字典的引用。

語法與行為

d.clear()
# 參數：無
# 回傳：None
# 效能：O(1) (CPython 實現只重置內部表格)
# 行為：就地修改，所有引用可見變化

基本範例

d = {'Name': 'Zara', 'Age': 7}
print(f'清空前長度: {len(d)}')  # 2

d.clear()
print(f'清空後長度: {len(d)}')  # 0
print(d)  # {}

clear() vs 重新賦值 關鍵差異

# 情境：多變數指向同一字典
original = {'a': 1}
ref1 = original
ref2 = original

# 使用 clear()
original.clear()
print(ref1)  # {}  受影響！
print(ref2)  # {}  受影響！

# 重新賦值
original = {'a': 1}
ref1 = original
ref2 = original

original = {}  # 建立新字典，original 指向新物件
print(ref1)  # {'a': 1}  不受影響！
print(ref2)  # {'a': 1}  不受影響！

何時用 clear()、何時用重新賦值

進階：自訂字典清空行為

class ObservableDict(dict):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.observers = []
    
    def clear(self):
        super().clear()
        self._notify('cleared')
    
    def _notify(self, event):
        for cb in self.observers:
            cb(self, event)

# 使用
od = ObservableDict(a=1, b=2)
od.observers.append(lambda d, e: print(f'字典{e}: {d}'))
od.clear()  # 觸發通知

相關方法對照

理解 clear() 的就地語意，能正確處理共享狀態場景，避免「以為清空了但引用還有舊資料」的 Bug。