如何在Python中正确深拷贝一个包含复杂引用关系的类对象？-Python教程-PHP中文网

copy.deepcopy 失效是因为类含不可序列化私有状态或未完整实现 getstate__/__setstate__；需手动定义 __deepcopy 或确保 getstate 返回纯 python 结构并排除不可拷贝字段。

如何在python中正确深拷贝一个包含复杂引用关系的类对象？

深拷贝时 `copy.deepcopy` 为什么突然失效？

因为类定义了 __dict__ 之外的私有状态（比如 C 扩展对象、文件句柄、线程锁），或重写了 __getstate__/__setstate__ 但逻辑不完整，copy.deepcopy 就会跳过某些字段或抛出 TypeError: cannot pickle 'thread.lock' object。这不是 bug，是它按协议走完流程后发现不可序列化就放弃。

先检查类是否实现了 __getstate__：如果返回字典但漏了某个动态属性（如 self._cache），深拷贝后该属性直接消失
若类中持有 threading.Lock()、socket.socket、sqlite3.Connection 等不可序列化对象，deepcopy 必报错，必须手动排除
避免在 __init__ 里做副作用操作（如打开文件），否则深拷贝后两个对象可能共享同一资源句柄

如何让自定义类支持可靠深拷贝？

核心是显式控制哪些字段参与拷贝，并确保重建逻辑幂等。不要依赖默认行为。

在类中定义 __copy__ 和 __deepcopy__ 方法，接收 memo 参数并手动构造新实例
若用 __getstate__，返回值必须是纯 Python 数据结构（dict、list、str 等），且包含所有关键状态字段
在 __setstate__ 中只做赋值，不调用外部副作用函数；如有缓存需重置，写成 self._cache = {} 而非 self._build_cache()

示例：

def __deepcopy__(self, memo):<br>    new_obj = self.__class__.__new__(self.__class__)<br>    memo[id(self)] = new_obj<br>    for k, v in self.__dict__.items():<br>        if k not in {'_lock', '_fd'}:  # 排除不可拷贝字段<br>            setattr(new_obj, k, copy.deepcopy(v, memo))<br>    return new_obj

遇到循环引用时 `deepcopy` 卡住或爆栈怎么办？

Python 的 deepcopy 内部靠 memo 字典记录已拷贝对象 ID 来破循环，但如果类重写了 __eq__ 或 __hash__ 导致 ID 比较失效，或存在极深嵌套（>1000 层），就会出问题。

Shadows Python Sensei

Python 最佳实践助手——代码规范、设计模式、性能优化、测试与类型注解。适用于编写或审查 Python 代码。

下载

先用 sys.setrecursionlimit(3000) 临时放宽限制（仅调试用，不推荐上线）
更稳妥的是拆解引用：把双向链表改为单向 + 索引 ID，或用弱引用 weakref.ref 替代强引用
检查是否意外创建了闭包引用（比如方法内嵌套 lambda 捕获了 self），这类引用不会被 __dict__ 暴露，但会被 deepcopy 追踪到

第三方库对象（如 NumPy 数组、PyTorch 张量）怎么安全深拷贝？

它们通常重写了 __deepcopy__，但行为和内置类型不同：NumPy 默认浅拷贝视图，PyTorch 的 .clone() 不复制计算图。直接丢给 copy.deepcopy 可能浪费内存或破坏语义。

NumPy 数组优先用 arr.copy()（明确语义，比 deepcopy 快 3–5 倍）
PyTorch 张量用 t.clone().detach().requires_grad_(t.requires_grad) 才等价于深拷贝

如果类里混用了这些对象，在 __deepcopy__ 中要单独处理：

if isinstance(v, np.ndarray):<br>    setattr(new_obj, k, v.copy())<br>elif hasattr(v, 'clone') and callable(getattr(v, 'clone')):<br>    setattr(new_obj, k, v.clone().detach())

真正麻烦的不是语法，而是得想清楚“这个字段在拷贝后是否应该独立”——比如一个全局配置对象，深拷贝反而该复用；而一个缓存字典，必须隔离。没想清语义，代码写得再工整也白搭。