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 兼容结构,它快且无依赖;否则别碰。
立即学习“Java免费学习笔记(深入)”;
动态WEB网站中的PHP和MySQL详细反映实际程序的需求,仔细地探讨外部数据的验证(例如信用卡卡号的格式)、用户登录以及如何使用模板建立网页的标准外观。动态WEB网站中的PHP和MySQL的内容不仅仅是这些。书中还提到如何串联JavaScript与PHP让用户操作时更快、更方便。还有正确处理用户输入错误的方法,让网站看起来更专业。另外还引入大量来自PEAR外挂函数库的强大功能,对常用的、强大的包
手动实现或使用 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 优化有限 - 除非你明确知道要定制行为(比如跳过某些字段、转换特定类型),否则不建议从零写
真正复杂的需求往往不是“怎么深拷”,而是“哪些字段不该深拷”——这时候该设计可序列化的数据结构,而不是堆砌克隆逻辑。









