Python如何序列化类实例使其无需依赖原脚本即可正常反序列化

原生pickle序列化时仅存储实例的属性数据、以及所属类的模块导入路径，反序列化时必须能够导入对应模块的类才能重建实例，因此删除原脚本后会抛出模块找不到的错误。你可以通过以下两种方案实现无原脚本依赖的序列化，均不需要手动处理嵌套类的属性：

方案1：使用dill库（推荐，适配复杂场景） #

dill是pickle的扩展库，支持直接序列化类的完整定义（包括属性、方法、继承关系等），无需依赖原模块存在，用法和pickle几乎完全一致，适配多层嵌套类的场景。

1. 先安装dill：

pip install dill

2. 修改序列化逻辑（test.py）：

import dill
import test_class_pickle

tc = test_class_pickle.Test()
dill.dump(tc, open("/home/user/testclass", "wb"))

3. 修改反序列化逻辑（test_class_unpickle.py），不需要导入原类模块：

import dill

tc = dill.load(open("/home/user/testclass", "rb"))
# 实例属性、方法都可以正常调用
print(tc.var1, tc.var2)
tc.print_vars()

即使删除test_class_pickle.py，反序列化也可以正常运行。

方案2：Python原生实现（无需第三方依赖） #

如果不想引入第三方库，可以手动打包类定义和实例属性，反序列化时动态创建类：

1. 序列化逻辑：

import pickle
import test_class_pickle

tc = test_class_pickle.Test()
# 打包类成员（过滤掉魔法方法）和实例属性
serialized_payload = {
    "class_def": {k:v for k, v in test_class_pickle.Test.__dict__.items() if not k.startswith("__")},
    "instance_attrs": tc.__dict__
}
pickle.dump(serialized_payload, open("/home/user/testclass", "wb"))

2. 反序列化逻辑：

import pickle
from types import SimpleNamespace

payload = pickle.load(open("/home/user/testclass", "rb"))
# 动态生成临时类
Test = type("Test", (SimpleNamespace,), payload["class_def"])
# 重建实例
tc = Test(**payload["instance_attrs"])

print(tc.var1, tc.var2)
tc.print_vars()

该方案适合普通自定义类场景，如果类涉及元类、多继承等复杂特性，需要调整动态建类的逻辑。

注意事项 #

• 两类方案都需要保证序列化和反序列化的Python大版本一致，避免语法不兼容
• 如果类内部引用了其他第三方库的对象，反序列化环境需要安装对应的依赖库
• 不要加载来源不明的序列化文件，两类方案都和pickle一样存在执行任意代码的安全风险

内容的提问来源于stack exchange，提问作者Sylvester is on codidact.com