当前位置：首页 > 文章列表 > 文章 > python教程 > Pythonpickle序列化教程详解

Pythonpickle序列化教程详解

2026-01-11 20:36:46 0浏览收藏

golang学习网今天将给大家带来《Python序列化详解：pickle机制教程》，感兴趣的朋友请继续看下去吧！以下内容将会涉及到等等知识点，如果你是正在学习文章或者已经是大佬级别了，都非常欢迎也希望大家都能给我建议评论哈~希望能帮助到大家！

Pickle 是 Python 默认对象序列化工具，用于保存对象状态和重建逻辑，依赖解释器、类定义及代码版本，存在兼容性与安全风险；支持基本类型、顶层函数、类实例等，不支持文件对象、嵌套类等；可通过 __getstate__ 和 __setstate__ 控制序列化行为；协议版本 0–5 影响性能与兼容性；反序列化不受信任数据会导致 RCE，应优先选用 JSON、Protocol Buffers 等安全替代方案。

Python对象序列化_pickle机制解析【教程】

Pickle 是 Python 默认的对象序列化工具，它能把内存中的对象转换成字节流，便于存储或传输，之后还能原样还原。但它的核心不是“存数据”，而是“保存对象的状态和重建逻辑”——这意味着它依赖 Python 解释器、类定义、模块路径，甚至代码版本。用不好容易报错、不兼容、甚至有安全风险。

pickle 能序列化什么？哪些会失败？

支持的类型包括：基本数据类型（int/str/list/dict/tuple/set）、函数（仅限顶层定义的函数，不能是 lambda 或嵌套函数）、类实例（要求类在模块顶层且可被 import）、大多数内置类型（如 datetime、Decimal）。

常见失败情况：

文件对象、网络连接、数据库游标等系统资源类对象无法序列化
类定义不在模块顶层（比如在函数内定义的 class）会报 AttributeError: Can't pickle local object
使用了 C 扩展或自定义 __reduce__ 但返回非法格式时会出错
不同 Python 版本间默认协议不兼容（如 3.8 用 protocol=4 序列化的数据，3.7 可能无法加载）

如何控制序列化行为？\_\_getstate\_\_ 和 \_\_setstate\_\_ 是关键

默认情况下，pickle 会保存对象的整个 __dict__。如果想排除某些属性（比如临时缓存、打开的文件句柄），或需要自定义重建逻辑，就该重写这两个方法：

__getstate__ 返回一个字典，表示“你想保存哪些状态”。可以删掉不可序列化的字段，或替换为可序列化的值
__setstate__ 接收这个字典，在反序列化时手动恢复对象状态，比如重新打开资源、重建缓存

例如：

class CacheHolder:
  def __init__(self, data):
    self.data = data
    self._cache = {}  # 不想保存
  def __getstate__(self):
    state = self.__dict__.copy()
    state.pop('_cache', None)
    return state
  def __setstate__(self, state):
    self.__dict__.update(state)
    self._cache = {}  # 反序列化后初始化空缓存