JavaScript深浅拷贝全面解析

本文深入剖析了JavaScript中深浅拷贝的本质区别与实用实现方案：浅拷贝仅复制顶层属性，嵌套对象仍共享引用，易引发意外修改；而深拷贝需严谨处理循环引用、多类型判断（Date、RegExp、Map、Set等）及特殊值（undefined、function、Symbol等），JSON序列化法虽简但缺陷明显。文章不仅详解手写深拷贝的核心逻辑（如WeakMap缓存防循环）、各原生方法的适用边界与坑点，更强调现代开发应优先采用标准化的structuredClone()（兼顾兼容性与能力），或成熟库如lodash.cloneDeep()，同时提醒开发者回归问题本质——许多所谓“深拷贝需求”，实则可通过不可变更新、状态管理优化或Object.freeze等更轻量方式解决。

浅拷贝只复制第一层，对象嵌套会共享引用

JavaScript 中的浅拷贝不会递归复制嵌套对象或数组，只是把顶层属性的值（如果是基本类型）或引用（如果是对象/数组）复制一份。这意味着修改原对象的深层属性，拷贝对象也会跟着变。

常见写法有：Object.assign()、扩展运算符 {...obj}、Array.prototype.slice()、[...arr]。它们都只处理第一层：

const a = { x: 1, y: { z: 2 } };
const b = { ...a };
b.y.z = 99;
console.log(a.y.z); // 99 —— 原对象被意外修改

• Object.assign({}, obj) 不会拷贝原型链上的属性，也不处理 symbol 键（除非显式传入）
• 扩展运算符对 null 或 undefined 会报错，而 Object.assign() 会跳过
• 数组浅拷贝时，slice() 和 concat() 兼容性更好，适合需要支持 IE 的场景

JSON.parse(JSON.stringify()) 是最简深拷贝，但有严重限制

这是新手常用“取巧”方式，原理是把对象序列化成字符串再反解析，天然跳过引用问题。但它会丢数据、报错或静默失败：

const obj = { a: 1, b: undefined, c: function() {}, d: Symbol('x'), e: new Date(), f: /abc/ };
JSON.parse(JSON.stringify(obj)); // { e: "2023-01-01T00:00:00.000Z" } —— 其他字段全没了

• undefined、function、symbol、BigInt 类型会被忽略或报错
• Date 变成字符串，RegExp 变成空对象，Map/Set 直接丢失
• 遇到循环引用（如 obj.self = obj）直接抛 TypeError: Converting circular structure to JSON

手写深拷贝要处理循环引用、类型判断和特殊对象

真正可靠的深拷贝必须记录已遍历的对象，避免无限递归；还要区分 Array、Date、RegExp、Map、Set 等类型并分别构造新实例。

核心逻辑是用 WeakMap 缓存源对象 → 拷贝对象的映射关系：

function deepClone(obj, cache = new WeakMap()) {
  if (obj === null || typeof obj !== 'object') return obj;
  if (cache.has(obj)) return cache.get(obj);
  
  let cloned;
  if (obj instanceof Date) cloned = new Date(obj);
  else if (obj instanceof RegExp) cloned = new RegExp(obj);
  else if (obj instanceof Array) cloned = [];
  else if (obj instanceof Map) cloned = new Map();
  else if (obj instanceof Set) cloned = new Set();
  else cloned = {};
  
  cache.set(obj, cloned);
  
  for (const key in obj) {
    if (Object.prototype.hasOwnProperty.call(obj, key)) {
      cloned[key] = deepClone(obj[key], cache);
    }
  }
  
  return cloned;
}

• WeakMap 是关键：它能自动回收，且只接受对象作键，天然适配引用追踪
• 不能用 for...in 遍历 Array，但这里用它配合 hasOwnProperty 是为了兼容类数组和普通对象混合场景
• 没处理 TypedArray、Promise、Error 等，实际项目建议用 structuredClone() 或成熟库

现代浏览器可用 structuredClone()，但注意兼容性和边界

structuredClone() 是目前最接近“开箱即用”的标准深拷贝 API，支持 Map、Set、Date、RegExp、ArrayBuffer、TypedArray、BigInt、undefined（仅在对象属性中），还能自动检测循环引用。

但它不支持 function、Symbol、DOM 节点，且 Node.js 直到 v17.0+ 才通过 globalThis.structuredClone 提供（需启用 --experimental-structured-cloning）：

try {
  const copy = structuredClone(original);
} catch (err) {
  if (err.name === 'DataCloneError') {
    // 包含 function 或 Symbol，需降级处理
  }
}

• Chrome 98+、Firefox 94+、Safari 15.4+ 支持，但 iOS Safari 15.4 有 bug（对某些 RegExp 失败）
• 它基于结构化克隆算法，和 postMessage() 底层一致，所以不能拷贝带私有字段的类实例
• 如果项目已支持现代环境，优先用它；否则用 lodash.cloneDeep() 更稳妥

实际用的时候，别一上来就手写全套深拷贝。先问自己：是否真需要深拷贝？能否改用不可变更新（如 immer）？有没有可能只是想冻结对象？很多“深拷贝需求”，其实是状态管理或副作用控制没理清。

到这里，我们也就讲完了《JavaScript深浅拷贝全面解析》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！