javaScript深度拷贝无统一内置方法,常用方式有:jsON序列化(简单但限制多)、structuredClone()(现代浏览器推荐,支持循环引用和多种对象)、递归手写(兼容旧环境、可定制)、Lodash的_.cloneDeep()(开箱即用、覆盖边界情况)。

javascript深度拷贝没有统一的内置方法,但有几种常用且可靠的实现方式,选择取决于数据结构复杂度、是否含特殊对象(如date、regexp、map、Set)、以及是否需要兼容旧环境。
json序列化与反序列化(最简单但限制多)
适合纯JSON兼容的数据:只含基本类型、普通对象、数组,不含函数、undefined、symbol、Date、正则、循环引用等。
- 用法:
JSON.parse(JSON.stringify(obj)) - 会自动忽略函数、undefined、Symbol属性
- Date对象会被转成字符串,RegExp变成空对象
- 遇到循环引用直接报错
TypeError: Converting circular structure to JSON
结构化克隆(现代浏览器推荐)
structuredClone() 是ES2022正式引入的原生API,支持Map、Set、Date、RegExp、ArrayBuffer、TypedArray、Error、Blob、File等,也处理循环引用,但暂不支持函数和undefined(会抛错)。
- 用法:
structuredClone(obj) - 目前主流浏览器(chrome 98+、firefox 94+、safari 15.4+)已支持
- node.js 17.0+ 启用
--harmony-structured-clone标志后可用,18.13+ 默认启用 - 不支持函数、undefined、window对象等非可传输值
递归手写深拷贝(可控性强,适合定制)
适用于需要兼容老环境、或需特殊处理(如保留函数、转换Date格式、跳过某些字段)的场景。关键点是识别类型、处理循环引用、递归遍历。
立即学习“Java免费学习笔记(深入)”;
function deepClone(obj, map = new WeakMap()) { if (obj === null || typeof obj !== 'object') return obj; if (map.has(obj)) return map.get(obj); let clone; if (obj instanceof Date) clone = new Date(obj); else if (obj instanceof RegExp) clone = new RegExp(obj); else if (Array.isArray(obj)) clone = obj.map(item => deepClone(item, map)); else if (obj instanceof Map) clone = new Map([...obj].map(([k, v]) => [k, deepClone(v, map)])); else if (obj instanceof Set) clone = new Set([...obj].map(item => deepClone(item, map))); else { clone = Object.create(Object.getPrototypeOf(obj)); map.set(obj, clone); for (let key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { clone[key] = deepClone(obj[key], map); } } } map.set(obj, clone); return clone; }
Lodash等工具库(开箱即用)
_.cloneDeep() 是最成熟的第三方方案,覆盖几乎所有边界情况:函数、原型链、循环引用、不可枚举属性、宿主对象等都支持。
- 体积稍大(约7KB gzip后),但稳定、测试充分
- 支持自定义克隆行为(通过
customizer函数) - 若项目已引入Lodash,优先用它;否则为轻量可选原生方案
基本上就这些。日常开发中,能用 structuredClone 就用它;要兼容IE或老Node,选手写或Lodash;简单配置对象且确定无坑,JSON法也够用。