萬盛學電腦網

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

Python pickle 序列化與反序列化完整指南

pickle 是 Python 內建的物件序列化模組,支援任意物件圖的持久化。本文涵蓋基本讀寫、協定版本、類別定義依賴、clear_memo 優化與安全性警示。

基本 API

  • pickle.dump(obj, file, protocol=0):序列化寫入檔案物件。protocol:0=文字、1/2=二進制 (更快、更小)。
  • pickle.load(file):反序列化還原物件。
  • pickle.dumps/loads:操作 bytes 而非檔案。

完整範例:自訂類別持久化

import pickle

class Person:
    def __init__(self, n, a):
        self.name = n
        self.age = a
    def show(self):
        print(f"{self.name}_{self.age}")

aa = Person("JGood", 2)
aa.show()

with open('p.txt', 'wb') as f:  # 二進制模式
    pickle.dump(aa, f, protocol=2)

with open('p.txt', 'rb') as f:
    bb = pickle.load(f)
bb.show()

關鍵陷阱:類別定義必須可見

反序列化時需能 import 到類別定義,否則拋出 AttributeError: module has no attribute 'Person'。常見解法:

  • 將類別定義放在獨立模組並確保可匯入。
  • 使用 __reduce__ 自訂序列化邏輯。
  • 避免在 __main__ 定義類別再 pickle(互動式環境常見)。

效能優化:clear_memo

Pickler 內部備忘錄記錄已序列化物件參考,避免重複序列化同一物件:

import pickle, io

fle = io.BytesIO()
pick = pickle.Pickler(fle)
pick.dump(aa)
print(len(fle.getvalue()))  # 66

pick.clear_memo()  # 清空備忘錄
pick.dump(aa)
print(len(fle.getvalue()))  # 132 (重複序列化)

預設不 clear_memo 時第二次 dump 僅寫入參考 (極小增量)。大量重複物件時可大幅減小輸出體積。

安全性警示 ⚠️

絕對不要 pickle.load 不受信任的資料!Pickle 可執行任意程式碼(透過 __reduce__),等同 eval。網路傳輸、使用者上傳檔案請改用 json、msgpack、protobuf 等安全格式。

適用場景總結

  • ✅ 本地快取、進程間通訊 (信任環境)、複雜物件圖持久化。
  • ❌ 網路 API、設定檔、使用者資料、跨語言互通。
copyright © 萬盛學電腦網 all rights reserved