17370845950

structuredClone()是现代浏览器首选深拷贝方案，支持Date、RegExp、Map、Set等并处理循环引用，但不支持function、undefined、Symbol等；JSON.parse(JSON.stringify())仅适用于纯数据对象；lodash.cloneDeep()功能全面但体积较大。

JavaScript 中没有原生的深拷贝函数，JSON.parse(JSON.stringify(obj)) 看似简单，但会丢函数、undefined、Symbol、循环引用，不能当真用。

用 structuredClone() —— 现代浏览器首选

这是目前最接近“标准答案”的方案，支持 Date、RegExp、Map、Set、ArrayBuffer 等，也处理循环引用（只要可克隆）。

• 仅限现代环境：Chrome 98+、Firefox 94+、Safari 15.4+，Node.js 17.0+（需启用 --experimental-structured-cloning，18.10+ 默认开启）
• 不支持 function、undefined、Symbol、Promise、Error 实例 —— 这些本就不在 structuredClone 规范的可克隆类型列表中
• 遇到不可克隆值会直接抛错：DOMException: Cannot clone object with symbol properties

const obj = { a: 1, b: new Date(), c: new Map([[1, 'x']]) };
const cloned = structuredClone(obj); // ✅ 安全、简洁、语义明确

JSON.parse(JSON.stringify()) 的真实适用边界

它不是深拷贝“方法”，而是一个带严重副作用的 hack，只适用于纯数据对象（POJO）且不含以下内容：

• function 或 undefined 字段（会被静默删除）
• Date 变成字符串、RegExp 变成空对象 {}
• NaN、Infinity 变成 null
• 循环引用直接报错：TypeError: Converting circular structure to JSON
• 有 Symbol 键时，该键被忽略

如果你确定输入是“API 响应体”这类纯 JSON 兼容结构，它快且无依赖；否则别碰。

手动实现或使用 lodash.cloneDeep() —— 需权衡体积与兼容性

lodash.cloneDeep() 是最成熟的通用解，能处理函数（只复制引用）、undefined、Symbol、循环引用、类实例（浅层）等，但要注意：

• 打包后约 20KB（gzip 后 ~7KB），对轻量项目可能是负担
• 对自定义类（如 class Person {}）只做浅拷贝其属性，不调用构造函数或 clone 方法
• 若你只用一次深拷贝，引入整个 Lodash 不划算；可考虑更轻量的替代，如 klona（~400B）或 fast-deep-equal 的配套工具

import { cloneDeep } from 'lodash-es';
const obj = { fn: () => {}, sym: Symbol('a'), date: new Date() };
const cloned = cloneDeep(obj); // ✅ 函数保留引用，Symbol 和 Date 都保留

自己写递归拷贝？先想清楚边界和性能

手写容易漏掉：TypedArray、BigInt、WeakMap/WeakSet（无法遍历，也不能克隆）、error.stack、原型链、不可枚举属性、getter/setter。

• 循环引用必须用 WeakMap 缓存已处理对象，否则栈溢出
• 对 Map/Set 要用 new Map(iterable) 构造，不能只展开键值
• 大量嵌套对象时，递归比 structuredClone 慢一个数量级，且 V8 优化有限
• 除非你明确知道要定制行为（比如跳过某些字段、转换特定类型），否则不建议从零写

真正复杂的需求往往不是“怎么深拷”，而是“哪些字段不该深拷”——这时候该设计可序列化的数据结构，而不是堆砌克隆逻辑。