在JavaScript开发过程中，对象的拷贝操作十分常见，很多时候我们需要复制一个对象且修改副本不会影响原对象，这时候就需要用到深拷贝。structuredClone是近些年被广泛支持的用于实现深拷贝的原生API，使用起来比传统的递归拷贝方式更简洁高效。
structuredClone 基本用法
structuredClone的使用非常简单，它接收一个需要拷贝的值作为参数，返回该值的深拷贝结果，支持绝大多数JavaScript内置数据类型。
// 基础对象深拷贝示例
const originalObj = {
name: 'test',
age: 20,
hobbies: ['reading', 'coding'],
address: {
city: 'Beijing',
street: 'Main St'
}
};
const copiedObj = structuredClone(originalObj);
// 修改拷贝对象的嵌套属性，原对象不受影响
copiedObj.hobbies.push('swimming');
copiedObj.address.city = 'Shanghai';
console.log(originalObj.hobbies); // 输出 ["reading", "coding"]
console.log(originalObj.address.city); // 输出 "Beijing"
structuredClone 支持的数据类型
structuredClone 支持拷贝的数据类型非常丰富，覆盖了大部分日常开发场景的需求：
- 基础数据类型：字符串、数字、布尔值、null、undefined、BigInt、Symbol
- 内置对象：Date、RegExp、Map、Set、ArrayBuffer、TypedArray、Blob、File 等
- 普通对象、数组、嵌套结构对象
下面是拷贝特殊数据类型的示例：
// 拷贝 Date 和 Map 类型
const date = new Date('2024-01-01');
const map = new Map([['key1', 'value1'], ['key2', 2]]);
const copiedDate = structuredClone(date);
const copiedMap = structuredClone(map);
console.log(copiedDate === date); // 输出 false
console.log(copiedDate.getTime() === date.getTime()); // 输出 true
console.log(copiedMap.get('key1')); // 输出 "value1"
console.log(copiedMap === map); // 输出 false
structuredClone 与传统深拷贝方式的对比
在 structuredClone 出现之前，开发者通常使用递归遍历或者 JSON 序列化反序列化的方式实现深拷贝，这两种方式都有明显的局限性。
JSON 序列化反序列化方式
这种方式通过 JSON.parse(JSON.stringify(obj)) 实现深拷贝，但是无法处理 Date、RegExp、Map、Set 等特殊对象，函数、undefined 属性会被直接忽略，循环引用对象会导致报错。
const objWithDate = {
time: new Date(),
func: function() {}
};
const jsonCopied = JSON.parse(JSON.stringify(objWithDate));
console.log(jsonCopied.time); // 输出时间字符串，不是 Date 实例
console.log(jsonCopied.func); // 输出 undefined，函数被忽略
手写递归拷贝方式
手写递归需要处理不同类型的数据判断，还要解决循环引用的问题，代码逻辑复杂，容易遗漏特殊类型的处理，维护成本较高。
而 structuredClone 是原生实现，性能更好，不需要额外处理类型判断和循环引用问题，代码更简洁，不过它也有自己的使用限制。
structuredClone 的使用限制
structuredClone 并不是能拷贝所有类型的值，以下情况它会抛出错误：
- 无法拷贝函数、DOM 节点、Error 对象等不支持结构化克隆算法的数据类型
- 无法拷贝原型链上的自定义属性，只会拷贝对象自身的可枚举属性
如果需要拷贝上述不支持的类型，还是需要结合其他深拷贝方案处理。
适用场景
当我们需要深拷贝普通对象、数组、Map、Set、Date 等结构化克隆算法支持的类型，且不需要拷贝函数、DOM 节点等特殊对象时，优先使用 structuredClone，它的实现效率更高，代码更简洁。如果需要拷贝的类型不在支持范围内，再考虑使用自定义深拷贝函数实现。
JavaScriptstructuredClone深拷贝对象拷贝修改时间：2026-06-19 06:45:24