不能直接用JSON.parse(JSON.stringify(obj)),它会丢失Date、RegExp、undefined、function、Symbol、BigInt及循环引用;structuredClone()是目前浏览器端最简方案,但Node.js需18.15+/20.6+且不支持function/Symbol等。

JSON.parse(JSON.stringify(obj)) 能不能直接用?
不能直接用,尤其在生产环境。它会丢失 Date、RegExp、undefined、function、Symbol、BigInt 和循环引用,遇到就报错或静默丢弃。
常见错误现象:
JSON.parse(JSON.stringify({ date: new Date(), fn: () => {} })) → { date: "2024-01-01T00:00:00.000Z", fn: undefined },函数没了,Date 变字符串。
适用场景:只含简单 JSON 安全数据(字符串、数字、布尔、null、数组、纯对象)的临时调试或表单快照。
structuredClone() 是最简方案吗?
是目前浏览器端最接近“开箱即用”的深拷贝方法,原生支持 Date、Map、Set、ArrayBuffer、TypedArray、RegExp,还能处理循环引用。
立即学习“Java免费学习笔记(深入)”;
但要注意:
-
structuredClone()在 Node.js 17+ 才默认启用(需--enable-structured-cloning标志),Node.js 18.15+ / 20.6+ 才稳定支持 - 不支持
function、Symbol、undefined、Promise、Error—— 遇到直接抛DataCloneError - 不能拷贝带有不可枚举属性或访问器(
getter/setter)的对象
示例:
const obj = { a: 1, b: new Date(), c: new Map([[1, 'x']]) };
const copy = structuredClone(obj); // ✅ 成功手写递归实现要考虑哪些边界?
手写适合需要控制行为(如忽略某些字段、自定义拷贝逻辑)或兼容老环境的场景,但必须显式处理几类关键问题:
- 循环引用:用
WeakMap缓存已拷贝过的源对象,再次遇到时直接返回缓存值 - 特殊内置类型:分别判断
Array.isArray()、isDate()、isRegExp()、isMap()等,不能只靠typeof - 不可枚举与 Symbol 属性:需用
Object.getOwnPropertyNames()+Object.getOwnPropertySymbols() -
null和原始类型(string/number/boolean/bigint/symbol)要直接返回,避免误进递归
一个最小可用骨架:
function deepClone(obj, map = new WeakMap()) {
if (obj === null || typeof obj !== 'object') return obj;
if (map.has(obj)) return map.get(obj);
const clone = Array.isArray(obj) ? [] : {};
map.set(obj, clone);
for (const key of [...Object.keys(obj), ...Object.getOwnPropertySymbols(obj)]) {
clone[key] = deepClone(obj[key], map);
}
return clone;
}
Lodash 的 cloneDeep() 值得引入吗?
如果项目已用 Lodash 或能接受约 20KB(gzip 后 ~7KB)的体积,cloneDeep() 是最省心的选择:它覆盖了几乎所有边缘情况,包括 arguments、Error、Promise(浅拷其状态)、DOM 节点(克隆副本)、自定义 toJSON() 方法等。
但注意两点:
- 它不会拷贝原型链上的属性,只处理自有可枚举/不可枚举/Symbol 属性
- 对含有大量嵌套或超大对象的场景,性能不如
structuredClone()(后者底层 C++ 实现)
调用方式:
import { cloneDeep } from 'lodash-es';
const copy = cloneDeep(original);
实际用哪个,取决于你的运行环境、数据结构复杂度和是否允许第三方依赖。循环引用、Map/Set、Date 这些不是“偶尔出现”,而是“只要业务逻辑稍复杂就必然碰到”——别等线上出 bug 才回头补 WeakMap 缓存逻辑。










