0

0

如何序列化和反序列化一个Python对象(pickle)?

betcha

betcha

发布时间:2025-09-05 18:52:01

|

1018人浏览过

|

来源于php中文网

原创

pickle能序列化几乎所有Python对象,包括自定义类实例、函数等,但无法处理文件句柄、网络连接等外部资源,且存在跨版本兼容性问题;其反序列化过程可执行任意代码,因此不适用于不信任的数据源,易导致安全风险;相比JSON,pickle支持更丰富的Python类型且性能更高,但缺乏跨语言兼容性和安全性,JSON则更适合安全、可读、跨平台的数据交换场景。

如何序列化和反序列化一个python对象(pickle)?

Python的

pickle
模块是标准库中一个非常强大的工具,它能将几乎任何Python对象序列化(即转换为字节流,以便存储到文件或通过网络传输)和反序列化(即从字节流中恢复原始对象)。这个过程就像是给你的Python对象拍了一张“快照”,然后可以在需要的时候再“还原”出来。

使用

pickle
进行序列化和反序列化其实非常直观。你需要用到
pickle.dump()
来将对象序列化并写入文件,以及
pickle.load()
来从文件中读取字节流并反序列化回对象。

import pickle

# 假设我们有一个复杂的Python对象
class MyCustomObject:
    def __init__(self, name, value):
        self.name = name
        self.value = value
        self.data = {'key': [1, 2, 3], 'status': True}

    def greet(self):
        return f"Hello, I'm {self.name} with value {self.value}."

    def __repr__(self):
        return f"MyCustomObject(name='{self.name}', value={self.value})"

my_object = MyCustomObject("示例对象", 123.45)
another_data = {'numbers': [10, 20, 30], 'text': '这是一个字典'}

# 1. 序列化 (Pickling)
# 将对象写入文件,通常使用二进制写入模式 'wb'
file_path = 'my_data.pickle'
try:
    with open(file_path, 'wb') as f:
        pickle.dump(my_object, f)
        pickle.dump(another_data, f) # 可以在同一个文件中dump多个对象
    print(f"对象已成功序列化到 '{file_path}'")
except Exception as e:
    print(f"序列化失败: {e}")

# 2. 反序列化 (Unpickling)
# 从文件读取字节流并反序列化回对象,使用二进制读取模式 'rb'
try:
    with open(file_path, 'rb') as f:
        loaded_object = pickle.load(f)
        loaded_data = pickle.load(f) # 注意:需要按照dump的顺序load
    print(f"\n对象已成功从 '{file_path}' 反序列化。")
    print(f"加载的自定义对象: {loaded_object}")
    print(f"对象类型: {type(loaded_object)}")
    print(f"调用方法: {loaded_object.greet()}")
    print(f"加载的字典数据: {loaded_data}")
except FileNotFoundError:
    print(f"错误: 文件 '{file_path}' 未找到。")
except Exception as e:
    print(f"反序列化失败: {e}")

# 如果只是想将对象序列化成字节串而不是写入文件,可以使用 pickle.dumps() 和 pickle.loads()
# dumps (dump string)
pickled_bytes = pickle.dumps(my_object)
print(f"\n对象序列化为字节串: {pickled_bytes[:50]}...") # 只显示前50个字节

# loads (load string)
restored_object_from_bytes = pickle.loads(pickled_bytes)
print(f"从字节串反序列化的对象: {restored_object_from_bytes}")
print(f"调用方法: {restored_object_from_bytes.greet()}")

pickle
到底能序列化哪些类型的对象?它有什么限制吗?

在我看来,

pickle
的强大之处在于它几乎可以序列化Python中所有内建的数据类型——列表、字典、元组、集合、数字、字符串、布尔值,这些自然不在话下。更厉害的是,它还能处理自定义类的实例、函数、方法,甚至是模块。这意味着你可以保存一个程序的运行状态,包括各种复杂的数据结构和它们的行为,然后在未来某个时间点精确地恢复它们。我曾经用它来保存机器学习模型的训练状态,这样就不必每次都从头开始训练了,非常方便。

立即学习Python免费学习笔记(深入)”;

不过,它也不是万能的,有一些限制需要注意。首先,它不能序列化那些依赖于操作系统资源的对象,比如打开的文件句柄、网络连接、数据库连接等。这些对象的状态通常是瞬态的,并且与外部环境紧密耦合,无法简单地打包和恢复。其次,如果你的自定义类实例中包含了C扩展模块创建的对象,那么这些对象可能无法正确序列化,除非C扩展本身提供了特殊的处理机制。再者,当你在一个Python版本中序列化了一个对象,试图在另一个不同版本(尤其是大版本差异)的Python环境中反序列化时,可能会遇到兼容性问题,因为Python内部的对象表示方式可能发生了变化。这就像你用一个老版本的软件保存的文件,新版本可能无法完全兼容。

为什么说使用

pickle
序列化“不安全”?我们应该如何规避风险?

提到

pickle
,安全性是一个绕不开的话题,而且这真的很重要,我个人觉得甚至比它的功能本身更值得关注。为什么不安全?简单来说,反序列化一个
pickle
字节流,本质上就是在执行这段字节流所代表的Python代码。
pickle
的设计允许它在恢复对象时执行任意Python代码,这是它能够处理复杂对象图的关键所在。如果这个字节流来自一个不信任的源,那么攻击者就可以构造恶意的
pickle
数据,当你的程序对其进行反序列化时,就可能导致任意代码执行,比如删除文件、窃取数据,甚至完全控制你的系统。这可不是开玩笑的。

规避风险的核心原则就一个字:“信”。你绝不能反序列化来自不信任或未知来源的

pickle
数据。这一点怎么强调都不过分。如果你的应用需要接收外部数据,并且你无法保证这些数据的来源是绝对安全的,那么就不要使用
pickle
。退一步讲,如果你真的需要在受控环境中处理来自外部的
pickle
数据(这种情况很少见且风险极高),你可能需要考虑在沙箱环境中进行反序列化,或者严格限制
pickle.load
可以加载的类(Python 3.8+的
pickle.Unpickler
提供了
find_class
方法来做这个,但实现起来非常复杂且容易出错)。但我个人建议,只要有其他选择,就不要去冒这个险。对于外部数据交换,JSON、Protocol Buffers或YAML等是更安全、更通用的选择。

pickle
和 JSON 在序列化场景下各有什么优势和劣势?什么时候该用哪个?

Moshi Chat
Moshi Chat

法国AI实验室Kyutai推出的端到端实时多模态AI语音模型,具备听、说、看的能力,不仅可以实时收听,还能进行自然对话。

下载

pickle
和JSON都是序列化工具,但它们的设计哲学和适用场景大相径庭,我经常看到有人把它们混淆,或者在不合适的场景下使用。理解它们的差异,才能做出正确的选择。

pickle
的优势:

  • Python原生对象的支持: 它可以序列化几乎所有Python对象,包括自定义类的实例、函数、方法等,无需额外的编码/解码逻辑。这对于需要在Python程序内部持久化复杂对象非常方便。
  • 性能: 对于复杂的Python对象结构,
    pickle
    通常比JSON更快,因为它直接操作Python的内部表示。
  • 保持对象完整性: 它能完整地保存Python对象的类型信息和结构,反序列化后能得到一个功能完全相同的对象。

pickle
的劣势:

  • 安全性: 如前所述,反序列化不信任的
    pickle
    数据是巨大的安全隐患。
  • 语言绑定:
    pickle
    是Python特有的。它生成的字节流无法被其他编程语言直接理解和反序列化。如果你需要跨语言数据交换,
    pickle
    完全不适用。
  • 可读性差: 生成的是二进制数据,不具备人类可读性,不方便调试。

JSON的优势:

  • 跨语言兼容性: JSON(JavaScript Object Notation)是一种轻量级的数据交换格式,几乎所有主流编程语言都支持解析和生成JSON。这是它最大的优势。
  • 安全性: JSON只支持基本的数据类型(字符串、数字、布尔值、数组、对象、null),不包含任何可执行代码,因此从安全角度来看,处理来自不信任源的JSON数据要比
    pickle
    安全得多。
  • 人类可读性: JSON是文本格式,结构清晰,易于阅读和调试。

JSON的劣势:

  • 数据类型限制: JSON只能表示基本的数据类型。它无法直接序列化Python的自定义类实例、函数、日期时间对象、集合等。如果你想序列化这些,需要编写自定义的编码器和解码器,将它们转换为JSON支持的类型。
  • 性能: 对于非常复杂的Python对象,如果需要大量自定义编码,其性能可能不如
    pickle

什么时候该用哪个?

我的建议是:

  • 使用
    pickle
    的场景:
    • 当你需要在纯Python环境中持久化复杂的Python对象(例如机器学习模型、复杂的配置对象、程序状态),并且你完全信任数据来源时。
    • 你不需要与其他语言进行数据交互。
  • 使用JSON的场景:
    • 当你需要在不同编程语言或系统之间交换数据时。这是JSON的黄金应用场景。
    • 当你需要处理来自外部或不信任来源的数据时。
    • 当你只需要序列化基本的数据类型,或者可以接受为自定义类型编写简单的编码/解码逻辑时。
    • 当你希望数据是人类可读的,便于检查和调试。

简单来说,如果数据是“自产自销”且复杂,

pickle
很方便;如果数据要“出口或进口”且注重安全和通用性,JSON是更好的选择。两者各有千秋,没有绝对的优劣,关键在于根据具体需求做出最合适的判断。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

716

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

626

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

739

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

617

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1236

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

547

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

575

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

699

2023.08.11

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

7

2025.12.31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 0.6万人学习

Django 教程
Django 教程

共28课时 | 2.6万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.0万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号