JavaScript深度克隆如何实现_有哪些注意事项

JSON.parse(JSON.stringify(obj))不是万能解法,会丢失Date、RegExp、undefined、function、Symbol及循环引用,且Date变字符串、无法处理Map/Set等原生对象。

JSON.parse(JSON.stringify(obj)) 为什么不能当万能解法

它确实快,也够简单,但会直接丢掉 DateRegExpundefinedfunctionSymbol 和循环引用。比如:

const obj = { date: new Date(), fn: () => {}, undef: undefined, sym: Symbol('a') };
console.log(JSON.parse(JSON.stringify(obj)));
// { date: "2025-01-01T00:00:00.000Z", fn: null, undef: null, sym: null }

更危险的是遇到循环引用会直接抛错:TypeError: Converting circular structure to JSON

  • undefinedfunction 变成 null
  • Date 被转成 ISO 字符串,再 parse 回来就只是普通字符串
  • 丢失原型链和 getter/setter
  • 无法处理 MapSetTypedArray 等原生对象

手写递归深克隆要处理哪些关键类型

真正可控的深克隆必须逐类型判断,核心是识别并分别处理:基本类型、数组、普通对象、日期、正则、Map、Set、TypedArray、null/undefined,还要用 WeakMap 记录已克隆过的对象来破循环引用。

关键点:

  • Object.prototype.toString.call(x)typeof 更可靠,比如区分 ArrayRegExpMap
  • new x.constructor() 不安全——有些构造器不接受无参调用(如 RegExp 需要 source 和 flags)
  • MapSet 必须用构造函数新建实例,再遍历赋值;不能只拷 key/value
  • ArrayBuffer 和视图(Uint8Array 等),需用 .slice()new ctor(buffer, ...) 复制底层内存
function deepClone(obj, seen = new WeakMap()) {
  if (obj === null || typeof obj !== 'object') return obj;
  if (seen.has(obj)) return seen.get(obj);

  const type = Object.prototype.toString.call(obj).slice(8, -1);
  let cloned;

  if (type === 'Date') cloned = new Date(obj.getTime());
  else if (type === 'RegExp') cloned = new RegExp(obj.source, obj.flags);
  else if (type === 'Array') cloned = [];
  else if (type === 'Object') cloned = {};
  else if (type === 'Map') cloned = new Map();
  else if (type === 'Set') cloned = new Set();
  else if (type === 'ArrayBuffer') cloned = obj.slice(0);
  else if (ArrayBuffer.isView(obj)) {
    const buffer = obj.buffer.slice(0);
    cloned = new obj.constructor(buffer, obj.byteOffset, obj.length);
  } else return obj; // 其他不可克隆类型(如 Error、Promise)建议显式 throw

  seen.set(obj, cloned);

  if (type === 'Array' || type === 'Object') {
    for (const key in obj) {
      if (Object.prototype.hasOwnProperty.call(obj, key)) {
        cloned[key] = deepClone(obj[key], seen);
      }
    }
  } else if (type === 'Map') {
    obj.forEach((v, k) => cloned.set(k, deepClone(v, seen)));
  } else if (type === 'Set') {
    obj.forEach(v => cloned.add(deepClone(v, seen)));
  }

  return cloned;
}

structuredClone() 是什么?兼容性怎么样

structuredClone() 是浏览器和 Node.js(v17.0+)原生提供的异步安全深克隆 API,支持 DateRegExpMapSetArrayBufferTypedArrayBigIntObjectArray,还能自动处理循环引用。

但它不支持 functionundefinedSymbolErrorPromise —— 这些会抛 DataCloneError

  • Chrome 98+、Firefox 94+、Safari 15.4+ 支持
  • Node.js 需 v17.0+ 且启用 --experimental-structured-cloning(v18.15+ 默认开启)
  • 不能在 Web Worker 之外的上下文里克隆 Transferable 对象(如 ArrayBuffer 的 transfer 版本)
try {
  const cloned = structuredClone(original);
} catch (err) {
  if (err.name === 'DataCloneError') {
    // 含 function / Symbol / undefined 等不支持项
  }
}

第三方库(如 lodash.cloneDeep)的实际取舍

lodash.cloneDeep 稳定、覆盖全、有完善测试,支持自定义克隆逻辑(通过 customizer 函数),还做了性能优化(比如对大型数组用 Array.from 而非 for-in)。

但要注意:

  • 它默认不克隆 function(保留原引用),除非你手动改 customizer
  • HTMLCollectionNodeList 等宿主对象行为未定义,可能出意外
  • 打包体积增加约 15–20 KB(gzip 后 ~5 KB),纯前端项目需权衡
  • 它的循环检测靠内部缓存,和手写 WeakMap 本质一致,但抽象层略厚,调试时堆栈更深

如果项目已用 Lodash,直接用 cloneDeep 最省心;否则为单个功能引入整包,不如用 structuredClone 或精简手写版。

最常被忽略的一点:没有“通用深克隆”这回事——你的数据结构决定了该用哪个方案。含函数或 Symbol?别碰 JSON;要跨线程传数据?优先 structuredClone;需要 100% 控制权?手写并明确列出支持类型。