# 批量报表改副本却串改原始数据：用 copy 区分浅拷贝与深拷贝并定位嵌套字段

## 文档明确的机制

Python 官方 `copy` 文档首先划清了一个容易误解的边界：赋值语句不会复制对象，而是在目标和对象之间建立绑定。因此，在批量清洗报表时，写出 `working = report` 并不会得到一份可随意修改的新报表；两个名字指向同一个对象。若报表本身可变，或内部包含列表、字典等可变项，修改其中一个名字可见的数据，另一个名字也会看到变化。

`copy` 模块提供两类通用复制操作：`copy.copy(obj)` 返回浅拷贝，`copy.deepcopy(obj[, memo])` 返回深拷贝。二者的差异只在“复合对象”上才有意义，也就是包含其他对象的对象，例如列表、字典或类实例。

浅拷贝会创建一个新的复合对象，但会尽可能把原对象中找到的对象引用插入进去。换句话说，外层容器是新的，内部元素仍可能与原对象共享。对报表而言，如果只是替换顶层字典的某个键，浅拷贝可能足够；如果清洗规则要改的是某一行里的嵌套列表或嵌套字典，就可能通过共享引用影响原始数据。

深拷贝则会创建新的复合对象，并递归地把原对象中找到的对象复制后插入。因此，处理“报表对象 → 行列表 → 行字典 → 标签列表/明细字典”这类多层结构时，深拷贝更符合“保留原始快照、另建处理副本”的需求。

深拷贝还必须面对两个浅拷贝没有的问题：一是递归对象可能形成循环。文档说明，复合对象直接或间接引用自身时，递归复制可能陷入循环。二是深拷贝可能复制过多，把原本希望在副本之间共享的数据也复制一份。`deepcopy()` 的解决机制是维护一个 `memo` 字典，记录当前复制过程中已经复制过的对象；同时允许用户自定义类控制复制操作或要复制的组成部分。

文档也明确列出了复制边界：该模块不会复制 module、method、stack trace、stack frame、file、socket、window 或类似类型。函数和类会被“复制”，但浅拷贝和深拷贝都会原样返回原对象；文档说明这与 `pickle` 模块对待它们的方式兼容。因此，不能把“深拷贝了报表容器”理解为其中所有资源对象都会获得独立副本。

此外，许多集合可用自身的 `copy()` 方法制作浅拷贝，如 `list.copy()`、`dict.copy()`、`set.copy()`；序列也可用完整切片 `sequence[:]`。但文档提醒，这些方法和切片在复制子类实例时可能生成基础类型实例，而 `copy.copy()` 通常会返回同类型实例。类还可通过 `__copy__()`、`__deepcopy__(self, memo)` 控制复制行为；`__deepcopy__` 若需要递归复制组件，应调用 `deepcopy(component, memo)`，并把 `memo` 当作不透明对象使用。

## 团队自行约定的接手建议

以下是面向小团队报表清洗任务的接手约定，不属于 Python 文档承诺。

第一，先保存原始数据快照，再生成工作副本。输入可约定为一份包含嵌套列表或字典的报表对象，以及一组明确的清洗规则；输出至少包含三部分：原始数据快照、处理后副本、字段变更清单。不要只依赖变量命名表达“这是副本”，而应实际选择与嵌套层级匹配的复制方式。

第二，按修改位置选择复制深度。若只改报表顶层字段，可评估浅拷贝；若规则会进入行内字典、明细列表或更深字段，建议使用 `copy.deepcopy`。代码示例和验收清单应分开：示例只演示复制与修改路径，清单则逐项检查原始对象、副本对象和变更记录，避免把“能运行”当成“未串改”。

第三，变更清单建议记录字段路径、原值和处理后的值。对于多行记录，可再附上记录定位信息。这样复核人不需要逐字比对整份报表，也能确认变化是否只发生在预期副本和预期字段上。

第四，验收时重点检查嵌套共享：修改副本中的嵌套列表或字典后，原始快照中对应位置不得变化；顶层结构可以不同，但内部嵌套字段也必须独立核对。若报表里有方法、模块、文件、套接字等文档列明不会真正复制的对象，应把它们标为特殊资源，另行设计安全的接手方式，不能声称深拷贝已经把这些资源全部隔离。

第五，遇到递归对象或自定义类，应确认其复制协议。团队可以把 `memo` 作为 `deepcopy` 处理递归结构的机制来理解，但不要把它当作任意业务去重表；文档要求将其视为不透明对象。

## 边界与总结

`copy.deepcopy` 的适用范围是对象复制，不是所有资源的万能隔离方案。文档明确列出的模块、方法、栈追踪、栈帧、文件、套接字、窗口等类型不会被该模块真正复制；函数和类则会原样返回。因此，文章、代码注释或验收结论都不应承诺“深拷贝适用于所有资源对象”。

批量报表清洗的核心判断可以压缩为三句话：赋值只建立绑定；浅拷贝新建外层复合对象，但内部对象可能共享；深拷贝递归复制复合对象，并用 `memo` 处理当前复制过程中的已复制对象。只要报表修改深入嵌套字段，就应同时验证副本改动与原始快照保持不变，并用字段变更清单把可观察结果说清楚。

## 相关工具

[AI 工作流 ROI 诊断器](/demos/ai-workflow-roi-diagnostic/index.html) · 查看工具的输入要求、输出说明与适用范围。


来源：[批量报表改副本却串改原始数据：用 copy 区分浅拷贝与深拷贝并定位嵌套字段](https://docs.python.org/3/library/copy.html)
