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 免费学习笔记(深入)”;
- 用
WeakMap记录已拷贝的对象,避免无限递归 - 区分
null、基本类型、Date、RegExp、Array、Object、Map、Set 等并分别处理 - 示例片段核心逻辑:
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 法也够用。