structuredClone 是 Node.js v17.0+ 原生支持的深拷贝 API，基于 HTML 标准规范实现，能安全克隆 Map、Set、Date、RegExp、ArrayBuffer 等类型并处理循环引用，但不支持函数、Promise、DOM 节点等不可转移对象。
structuredClone 在 Node.js 中自 v17.0 起原生支持，无需 polyfill，它基于 HTML 标准规范实现，能安全、深度克隆可转移对象（如 ArrayBuffer、TypedArray、Map、Set、Date、RegExp、Error 等），并正确处理循环引用。
Node.js 版本支持与启用条件
该 API 从 Node.js v17.0 开始默认启用（需 --experimental-structured-clone 标志仅在 v16.x 的部分版本中临时需要）；v18.0 及后续稳定版已完全内置，直接调用即可。注意：低于 v17 的版本不支持，也不能通过 require 引入或手动实现标准行为——因为底层依赖 V8 的序列化机制，非纯 JS 实现可替代。
支持的类型与典型限制
structuredClone 能处理大多数结构化数据类型，但有明确边界：
- ✅ 支持：普通对象、数组、Map、Set、Date、RegExp、ArrayBuffer、DataView、TypedArray、BigInt、null、undefined、布尔/数值/字符串原始值、嵌套组合及循环引用
- ❌ 不支持：函数、Promise、DOM 节点、Window、globalThis、require、module、console、process、Buffer（注意：Node.js 的 Buffer 是 Uint8Array 子类，v18.12+ 起已支持）、自定义类实例（除非其属性全为可克隆类型且无私有字段）
- ⚠️ 注意：Error 对象可克隆，但堆栈信息（stack）在某些 V8 版本中可能丢失或为空（属实现细节，非规范要求）
与 JSON.stringify + JSON.parse 的关键区别
相比传统 JSON 方案，structuredClone 更可靠也更严格：
立即学习“Java免费学习笔记（深入）”；
- 保留类型信息：new Date() 克隆后仍是 Date 实例，而非字符串；Map 保持键值对和迭代顺序
- 支持 undefined 和 BigInt：JSON 会丢弃 undefined，且不识别 BigInt，而 structuredClone 完整保留
- 自动处理循环引用：JSON 方法会抛出“Converting circular structure to JSON”错误，structuredClone 则正常完成
- 不执行 toJSON() 或自定义序列化逻辑：它绕过对象方法，只拷贝数据结构本身，更“透明”
使用示例与常见注意事项
基本用法简洁直观：
const original = { date: new Date(), map: new Map([['a', 1]]), buffer: new ArrayBuffer(8) };const clone = structuredClone(original);
console.log(clone.date instanceof Date); // true
console.log(clone.map.size); // 1
需留意几点：
- 克隆结果与原对象完全独立：修改 clone 不影响 original，反之亦然（包括嵌套的可变对象）
- Transferable 对象（如 ArrayBuffer）在克隆时默认被移动（move），原对象对应字段变为 null（仅当显式传入 transfer option 时才生效，通常用于 Worker 场景；Node.js 中 transfer 目前未开放为公共选项，实际行为以 V8 默认为准）
- 性能优于手写深克隆，尤其对大型嵌套结构或含二进制数据的对象，但仍有开销，高频调用场景建议评估必要性
