深拷贝需正确处理引用类型、循环引用及特殊对象;JSON方法会丢失函数/undefined/Symbol/原型等;手写递归需分类判断+WeakMap防循环;structuredClone是现代首选但不支持函数/Symbol;Lodash cloneDeep最成熟但体积大;须避开镜像幻觉、性能陷阱、枚举误判和DOM/function误用。
JavaScript 实现深拷贝不能只靠 JSON.parse(JSON.stringify(obj)) 或简单循环,核心在于正确处理引用类型、循环引用、特殊对象(如 Date、RegExp、Map、Set、函数、undefined、Symbol)以及原型链。下面分几类说明常用方法和必须避开的坑。
看似简洁:const deepCopy = JSON.parse(JSON.stringify(obj));
但它会静默丢失很多关键信息:
new Date() → "2025-01-01T00:00:00.000Z"),不再是 Date 实例{}
TypeError: Converting circular structure to JSON
适合学习原理或轻量定制场景。关键是要分类判断 + 缓存已拷贝对象(防循环引用):
Object.prototype.toString.call(x) 精准识别 Array、Date、RegExp、Map、Set、Error 等new Date(date.getTime()))注意:不处理函数(通常不拷贝)、不保留不可枚举属性、不继承原型上的属性(除非显式遍历 Object.getOwnPropertyDescriptors)。
Chrome 98+、Firefox 94+、Node.js 17.0+ 支持原生 structuredClone():
使用示例:const copy = structuredClone(original);
兼容性不足时可用 ungap/structured-clone 垫片。
_.cloneDeep 最成熟覆盖场景最全,经过大量生产环境验证:
customizer 函数)klona)注意:Lodash 默认不拷贝原型链上的属性;若需继承,需额外配置或手动处理。
1. 把深拷贝当成“完全镜像”:即使 Lodash 也无法完美复制不可枚举属性、访问器属性(getter/setter)、内部插槽(如 Promise 的 [[PromiseState]]),这些本就不可枚举或不可暴露。
2. 忽略性能代价:大对象或深层嵌套结构下,深拷贝是 O(n) 时间 + 额外内存开销
。高频操作(如 React 中每次 render 拷贝 props)会导致卡顿,应优先用不可变更新(immer)或避免拷贝。
3. 混淆“可枚举性”与“存在性”:for...in 和 Object.keys() 不会遍历不可枚举属性(如 obj.toString),手写拷贝时若只依赖它们,就会漏掉。
4. 假设所有对象都“安全”:含 DOM 元素、window、document、function(尤其带闭包的)的对象无法被任何标准深拷贝方法处理,强行拷贝会出错或产生无意义结果。