JavaScript深拷贝实现方法及注意事项

JavaScript实现深拷贝没有万能方案，不同方法各有限制：JSON序列化简洁但仅适用于纯数据对象，遇Date、函数、Symbol等会丢失或报错；手写递归需精准类型判断、WeakMap缓存防循环引用，灵活但易出错；structuredClone原生支持多类型且自动处理循环引用，却排斥function和Symbol，兼容性仍有缺口；lodash.cloneDeep功能全面、兼容性强，但体积大、性能低。选择关键在于明确业务数据结构——先看清对象里有没有循环引用、函数或特殊类型，再按需选用最轻量、最稳妥的方案，而非盲目追求“最完整”。

JSON.parse(JSON.stringify(obj)) 能不能直接用？

能，但只适用于纯数据对象：不包含 Date、RegExp、undefined、function、Symbol、BigInt，也不能处理循环引用。一旦遇到这些，会静默丢失或报错。

• JSON.stringify(new Date()) → "2024-01-01T00:00:00.000Z"（变成字符串，不再是 Date 实例）
• JSON.stringify({ x: undefined }) → "{}"（键被丢弃）
• JSON.stringify({ x: () => {} }) → "{}"（函数被忽略）
• 含循环引用时直接抛 TypeError: Converting circular structure to JSON

手写递归深拷贝要注意什么？

核心是类型判断 + 递归复制 + 循环引用检测。不能只用 typeof，得靠 Object.prototype.toString.call() 精准识别内置对象类型。

• 必须用 Map 或 WeakMap 缓存已拷贝的源对象，避免无限递归
• null 是对象类型但不是可遍历对象，要单独处理
• Array 和普通 Object 需分别用 [] 和 {} 初始化，不能都用 {}
• Date、RegExp 等需要调用构造函数重建：new Date(obj)、new RegExp(obj)

function deepClone(obj, cache = new WeakMap()) {
  if (obj === null || typeof obj !== 'object') return obj;
  if (cache.has(obj)) return cache.get(obj);

  const cloned = Array.isArray(obj) ? [] : {};
  cache.set(obj, cloned);

  for (const key in obj) {
    if (Object.prototype.hasOwnProperty.call(obj, key)) {
      cloned[key] = deepClone(obj[key], cache);
    }
  }
  return cloned;
}

structuredClone() 是不是终极方案？

它是浏览器和 Node.js（v17.0+）原生提供的深拷贝 API，支持 Date、RegExp、Map、Set、ArrayBuffer 等，也自动处理循环引用 —— 但仍有明显限制：

• 不支持 function、undefined、Symbol、BigInt（遇到就抛 DataCloneError）
• 不支持带有不可枚举属性或访问器（getter/setter）的对象
• Node.js 中需启用 --experimental-structured-cloning（v17–v18），v19+ 默认开启
• IE 完全不支持，Safari 15.4+ 才开始支持

使用前建议先检查：typeof structuredClone === 'function'

第三方库如 lodash.cloneDeep 的实际代价

lodash.cloneDeep 兼容性好、覆盖类型全（包括 Uint8Array、Error、自定义类实例等），但它体积大（压缩后约 7KB），且内部做了大量特征检测和 fallback 处理，性能比手写简单递归慢 2–5 倍。

• 如果项目已用 Lodash，复用它省心；否则为单个深拷贝引入整包不划算
• 注意它默认不拷贝原型链上的属性，也不调用构造函数，和 structuredClone 行为不同
• 对含大量小对象的数组，可考虑用 structuredClone + 类型预过滤替代

循环引用、函数、Symbol 这三类问题，没有银弹。选方案前先看数据结构里到底有什么，而不是默认上最“完整”的那个。

终于介绍完啦！小伙伴们，这篇关于《JavaScript深拷贝实现方法及注意事项》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！