浅拷贝只复制第一层引用，修改嵌套对象仍会影响原数据；深拷贝需递归或序列化处理所有层级，structuredClone()是现代推荐方案但有类型限制，循环引用需WeakMap缓存避免栈溢出。
浅拷贝只复制第一层引用，修改嵌套对象仍会影响原数据
JavaScript 中的浅拷贝（shallow copy）仅复制对象或数组的顶层属性，对嵌套的引用类型（如对象、数组）只是复制了指针，新旧对象共享同一块内存。常见错误是以为 Object.assign() 或展开运算符 [...arr] 能完全隔离数据，结果在修改深层属性时意外改动了原始数据。
适用场景：只需隔离顶层字段，且确定内部结构不会被后续修改；或作为性能敏感场景下的临时方案。
-
Object.assign({}, obj)对对象有效，但不处理null、undefined或原型链 -
[...arr]或Array.from(arr)适合一维数组，对含对象的数组无效 -
structuredClone()是现代浏览器推荐方式，但目前不支持函数、undefined、Symbol和循环引用
深拷贝必须递归或序列化处理嵌套结构
真正意义上的深拷贝需确保所有层级的引用类型都生成独立副本。没有银弹方案，选择取决于环境限制和数据特征。
最稳妥的手写递归实现要处理：null、日期、正则、数组、普通对象、Map/Set 等类型，还要避免循环引用导致栈溢出。但多数项目中，更倾向用成熟方案降低维护成本。
立即学习“Java免费学习笔记（深入）”；
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- JSON 序列化（
JSON.parse(JSON.stringify(obj))）最常用，但会丢弃function、undefined、Symbol、Date、RegExp、NaN，且无法处理循环引用 -
structuredClone()是浏览器原生 API，支持Date、Map、Set、ArrayBuffer等，但 Node.js 17+ 才支持，且仍不支持函数 - Lodash 的
_.cloneDeep()兼容性最好，能处理函数（作为空对象）、循环引用、稀疏数组等边界情况，但引入依赖需权衡
遇到循环引用时，JSON 和 structuredClone 都会报错
当对象存在自引用（比如 a.b = a）或相互引用（a.b = b; b.a = a），JSON.stringify() 抛出 TypeError: Converting circular structure to JSON，structuredClone() 则抛出 DATA_CLONE_ERR。
此时必须用带缓存的递归方案：用 WeakMap 记录已拷贝的对象，遇到重复引用直接返回已有副本。
function deepClone(obj, map = new WeakMap()) {
if (obj === null || typeof obj !== 'object') return obj;
if (map.has(obj)) return map.get(obj);
const cloned = Array.isArray(obj) ? [] : {};
map.set(obj, cloned);
for (const key in obj) {
if (Object.prototype.hasOwnProperty.call(obj, key)) {
cloned[key] = deepClone(obj[key], map);
}
}
return cloned;
}
Node.js 环境下注意 structuredClone 的可用性与替代方案
Node.js 17.0+ 默认启用 structuredClone()，但低于该版本需降级处理。不能简单 fallback 到 JSON 方法——它会静默丢失数据，而应明确判断不可序列化字段并报错，或引入 node:util 的 inspect() + 自定义解析逻辑。
如果项目已使用 fast-copy 或 klona 这类轻量库，要注意它们对 Map/Set 的支持程度，以及是否默认处理 prototype 属性。
-
klona极快且无依赖，但不处理Map、Set、Date -
fast-copy支持更多类型，但比structuredClone()慢约 2–3 倍 - 自己实现时，别忘了检查
obj.constructor === Object，否则new obj.constructor()可能误调用自定义类构造器
structuredClone() 就够了；剩下那 10%，往往是因为你正在操作一个带方法或 Symbol 键的配置对象——这时候就得承认：拷贝不是目的，设计才是。 
