彻底理解 JavaScript 的深浅拷贝

引言

在我写代码的这几年里，关于对象的拷贝可以说是老生常谈的问题。尤其是当我在项目里修改某个对象属性时，另一个变量也跟着变了的时候，我才意识到：自己其实并没有真正理解“浅拷贝”和“深拷贝”的区别。
这篇文章，我想从自己的思考和实践出发，完整整理一下我对 JavaScript 深浅拷贝的理解和实现方式。

一、为什么要拷贝？

在 JavaScript 中，对象、数组、函数等引用类型是通过引用地址存储的。

const obj1 = { name: 'Liu', age: 25 }
const obj2 = obj1

obj2.age = 30
console.log(obj1.age) // 30

这时候 obj1 和 obj2 指向的是同一个内存地址，我改动一个，另一个就跟着变。
有些时候我只想复制出一份独立的数据，这就是“拷贝”存在的意义。

二、浅拷贝：复制第一层的引用

浅拷贝只会复制对象的第一层属性，更深层的对象依然是引用关系。

最常见的浅拷贝方式有几种：

1. Object.assign()

const obj = { name: 'Liu', info: { age: 25 } }
const copy = Object.assign({}, obj)
copy.info.age = 30

console.log(obj.info.age) // 30

虽然看起来 copy 是个新对象，但 info 还是共享的引用。

2. 展开运算符（...）

const copy = { ...obj }

效果和 Object.assign() 一样，只拷贝第一层。

三、深拷贝：复制整个结构

深拷贝会递归复制对象的所有层级，让副本与原对象完全独立。

1. JSON 方法（最简单的）

const obj = { name: 'Liu', info: { age: 25 } }
const copy = JSON.parse(JSON.stringify(obj))

优点是简单直接，缺点也不少：

• 无法拷贝 undefined、Symbol、Function
• 会丢失原型链
• 无法处理循环引用
• 日期会被转成字符串

但对于普通数据结构，这种方式足够用。

四、更靠谱的深拷贝实现

在我自己写项目时，真正遇到复杂对象（比如含 Date、Map、Set、循环引用）的情况，JSON 已经不够用了。

我后来总结出几种更稳定的做法：

1. MessageChannel 异步克隆

有时候我不想阻塞主线程，就用这种异步克隆技巧：

function cloneAsync(value) {
  return new Promise(resolve => {
    const { port1, port2 } = new MessageChannel()
    port1.onmessage = e => resolve(e.data)
    port2.postMessage(value)
  })
}

const clone = await cloneAsync(obj)

它利用浏览器的结构化克隆机制完成异步复制，非常稳定，也能处理循环引用。

2. 手写递归版

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

  const result = Array.isArray(obj) ? [] : {}
  hash.set(obj, result)

  for (const key in obj) {
    if (obj.hasOwnProperty(key)) {
      result[key] = deepClone(obj[key], hash)
    }
  }

  return result
}

这个版本支持循环引用，不会陷入死循环，是我自己项目里常用的一版。
当然，如果要支持 Map、Set、Symbol 等类型，还可以进一步扩展。

3. structuredClone

const copy = structuredClone(obj)

它能自动处理：

• 循环引用
• Date、RegExp、Map、Set、TypedArray
• 深层结构

就是函数、原型链还是不能保留，但在大多数前端场景下已经非常完美。

4. 三方工具

如果项目中已有该依赖，推荐使用，否则建议手写，或其他API。

4.1. lodash

const obj = { a: 1 }
_.cloneDeep(obj)

4.2. jquery

// 浅拷贝
const dest = $.extend({}, src) // 等价于 Object.assign({}, src)
// 深拷贝
const deep = $.extend(true, {}, src)