structuredClone 不是更快的深拷贝:本机实测慢 1.4 倍,字符串过 200 字符才反超

举报
yd_250310792 发表于 2026/11/17 05:10:05 2026/11/17
【摘要】 Node 17 起内置的 structuredClone 被当成 JSON 深拷贝的替代品,但实测它在普通对象上反而慢 1.4~2.8 倍,只有当字符串足够长(约 200 字符以上)才反超。同时它保住了 JSON 会丢掉的 Date、Map、Set、BigInt、循环引用,代价是函数、Symbol 键、class 原型一律不保。附 13 种类型的保真对照表和选择判据。

团队里有个共识:深拷贝用 structuredClone,比 JSON.parse(JSON.stringify()) 快,也更安全。前半句我信了很久,直到上周把一个 15MB 的接口响应从 JSON 方案换过去,接口平均耗时涨了 400 毫秒。


于是我把两边的边界都跑了一遍。结论是:structuredClone 并不更快,它只是**在特定形状的数据上**更快;而“更安全”也要打个折,它有自己的雷区。


下面全部数据实测于 Windows + Node v22.22.2,每档先预热再计时,多轮取中位数。


一、先看速度:常规对象上它明显更慢


三组典型负载,同一份数据分别用两种方式深拷贝:


| 场景 | JSON 方案 | structuredClone | 倍数 |

|---|---|---|---|

| 5 字段小对象 × 10 万次 | 209.8 ms | 385.7 ms | 慢 1.84 倍 |

| 1 万条记录 × 200 次 | 3911 ms | 5578 ms | 慢 1.43 倍 |

| 10 层嵌套树 × 5 万次 | 471 ms | 722 ms | 慢 1.53 倍 |

| 10 万条记录(14.9MB)× 5 次 | 1636 ms | 2282 ms | 慢 1.39 倍 |


四组全部是 structuredClone 更慢,差距 1.4 到 1.8 倍。这跟“内置 API 一定更快”的直觉相反,原因也不神秘:JSON 方案虽然要序列化成字符串再解析回来,但 V8 对 JSON.stringify/parse 做了十几年的专项优化,而且整个过程在 JS 堆里连续分配;structuredClone 走的是结构化克隆算法,要按类型分派、维护引用表处理循环引用,对象越多分派开销越明显。


二、拐点在哪:字符串长度 200 字符


真正让我意外的是另一组数据。同样 2000 条记录,只改 body 字段的长度,比值完全翻转:


| body 长度 | JSON 方案 | structuredClone | 倍数 |

|---|---|---|---|

| 10 字符 | 12.0 ms | 33.5 ms | 慢 2.79 倍 |

| 60 字符 | 23.5 ms | 38.1 ms | 慢 1.62 倍 |

| 150 字符 | 38.0 ms | 41.6 ms | 慢 1.09 倍 |

| 300 字符 | 57.6 ms | 45.8 ms | **快 1.25 倍** |

| 600 字符 | 100.2 ms | 59.9 ms | **快 1.67 倍** |

| 1200 字符 | 176.2 ms | 88.7 ms | **快 2.00 倍** |


拐点落在 150 到 300 字符之间,大约 200 字符。过了这条线,字符串越长,structuredClone 的优势越大——1200 字符时已经是 JSON 方案的 2 倍。


原因是两者的序列化格式不同。JSON 要把字符串里的每个字符扫描一遍,遇到引号、反斜杠、换行就转义,输出成一个巨大的 JS 字符串,再完整解析回来;structuredClone 用的是二进制格式,字符串基本按原始字节搬运,长度越大,省掉的转义和解析开销就越多。


所以选型判据其实是一句话:**数据里字符串的总字节数占大头,用 structuredClone;字段多、值短、对象粒度碎,用 JSON 方案。** 接口返回的富文本、日志、文章正文,属于前者;配置对象、状态树、坐标数组,属于后者。


三、保真度:它赢 11 项,输 2 项


速度只是半个理由,“不丢数据”才是大家换它的原因。我把常见类型逐个过了一遍,逐个比对原始值、JSON 结果、clone 结果:


| 类型 | JSON 方案 | structuredClone |

|---|---|---|

| Date | 变字符串 | 保持 Date |

| undefined 值 | 整个键消失 | 保留 |

| NaN / Infinity / -0 | 变 null / 变 0 | 保持 |

| Map / Set | 变 `{}` | 保持 |

| RegExp | 变 `{}` | 保持 |

| BigInt | 抛 TypeError | 保持 |

| TypedArray | 变普通对象 `{0:1,1:2}` | 保持 |

| Error | 变 `{}` | 保持 |

| 循环引用 | 抛 TypeError | 保持 |

| 稀疏数组 | 空位变 null | 保持空位 |

| 中文键名 | 正确 | 正确 |

| **函数属性** | **静默丢弃** | **抛 DataCloneError** |

| **Symbol 键** | **静默丢弃** | **静默丢弃** |


前 11 行是 structuredClone 的胜利,而且不是“更好一点”,是“根本不丢”。Date 变字符串这类问题在真实项目里最阴——存进去是 Date,取出来是字符串,`getTime()` 变成 undefined,报错点在几十行之外。


但第 12 行值得单独说。对象里挂了个函数,JSON 方案是**一声不响地把它删掉**,你拿到一个看起来正常的对象,直到某处调用才炸;structuredClone 直接抛 DataCloneError 告诉你“这个克隆不了”。后者更吵,但更接近正确——错误发生在源头。


第 13 行是两个人共同的盲区:Symbol 做键的属性,两种方案都静默丢失,谁都不报错。如果你的对象用 Symbol 存私有字段,深拷贝一圈回来字段就没了。


四、它也不是万能的:三处不保


**class 原型会丢。** 这是我原来最没想到的一条。`new User('x')` 用 structuredClone 克隆后,`instanceof User` 是 false,`greet()` 方法不存在,`Object.getPrototypeOf` 直接指向 `Object.prototype`。它保住的是 Map、Set、Date 这些**内置**类型的原型,用户自定义的 class 一律拍平成普通对象。所以“深拷贝一个领域对象”这条路,两种方案都走不通,得自己写构造函数或者用专门的库。


**getter 会被求值。** 带访问器的属性克隆后变成普通值属性,访问器本身没了。这个行为跟 JSON 方案一致,但如果你的 getter 有副作用或者依赖 `this` 上的其他状态,克隆的时机就会影响结果。


**toJSON 不认。** 实现了 `toJSON()` 的对象,JSON 方案会调用它、用返回值替代原对象(这是 Date 序列化的底层机制);structuredClone 不认识 `toJSON`,直接把那个方法当函数处理,然后抛 DataCloneError。依赖 `toJSON` 做脱敏、裁剪字段的类,切过来会直接报错。


另外补一个和性能有关的用法:structuredClone 支持 `transfer`,把 ArrayBuffer 的所有权转移过去而不是复制。实测转移 1MB 的 ArrayBuffer 只要 0.094 毫秒,转移后原 buffer 的 `byteLength` 变成 0。要在 worker 之间传大块二进制数据,这个是 JSON 方案完全做不到的——它连 ArrayBuffer 都认不出来。


五、怎么选


按我这两周的实践,判据按顺序问三个问题:


1. **要传 ArrayBuffer 或者跨 worker 吗?** 要,只能 structuredClone(transfer)。

2. **对象里有 Date、Map、Set、BigInt、循环引用吗?** 有,只能 structuredClone,否则数据静默变形。

3. **以上都没有,且数据是“字段多、值短”的形状吗?** 是,用 JSON 方案,快 1.4 到 2.8 倍。


还有一个前置条件经常被忽略:如果数据源头本来就是 JSON 文本(HTTP 响应、读文件),JSON 方案其实只做了一半的活——你已经有字符串了,`JSON.parse` 一次就够,根本不需要 `stringify`。这种情况下 structuredClone 完全没有优势可言。


反过来说,如果数据是从数据库或 ORM 拿到的对象树,里面混着 Date 和 Buffer,那 JSON 方案就是在拿正确性换速度,而且换得很不划算:一次 Date 变形带来的排查成本,远超省下的那几百毫秒。


总结


structuredClone 是一个**正确性工具**,不是一个性能工具。它在常规对象上比 JSON 深拷贝慢 1.4 到 2.8 倍,只有当字符串足够长(约 200 字符以上)才反超,1200 字符时能快一倍。它保住了 Date、Map、Set、BigInt、Error、TypedArray、循环引用、undefined、NaN 这些 JSON 一定会弄丢的东西,但不保 class 原型、不认 toJSON、遇到函数直接抛错。


写代码的时候,别默认“内置的更现代所以更好”,也别默认“JSON 深拷贝是土办法”。这两个判断我都做过,都被数据打了脸。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。