JavaScript 中 structuredClone 深拷贝怎么处理 Symbol 类型的转换-js教程-PHP中文网

structuredClone 丢弃 Symbol 是因其不可序列化，HTML 标准明确排除；示例中 Symbol 键值均消失；替代方案包括手动处理、自定义深拷贝、WeakMap 分离或改用字符串键。

javascript 中 structuredclone 深拷贝怎么处理 symbol 类型的转换

structuredClone 无法拷贝 Symbol 类型，它会直接丢弃（忽略）所有 Symbol 键和 Symbol 值，且不报错。

为什么 Symbol 会被丢弃？

structuredClone 遵循 HTML 标准的结构化克隆算法，该算法只支持可序列化的数据类型。Symbol 是不可序列化的原始值——它没有字面量表示，不能被 JSON 化，也没有跨上下文唯一标识机制（即使同名 Symbol 也互不相等），因此被明确排除在克隆范围之外。

实际表现示例

以下代码中，Symbol 键和 Symbol 值均不会出现在克隆结果中：

Java调试

通过 JDWP 实现 Java 远程调试：连接远程 JVM、设置断点、单步执行代码、查看变量值、获取调用栈。适用于需要调试远程 Java 应用、排查运行时状态、追踪代码执行流程的场景。术语注解 JDWP：Java Debug Wire Protocol，Java 调试有线协议（Java 远程调试底层通信协议） remote JVM：远程 Java 虚拟机 step through code：代码单步调试（步入 / 步过 / 步出调试） inspect variables：变量查看 / 变量检视 stac

下载

const obj = {
  [Symbol('id')]: 123,
  name: 'Alice',
  meta: { [Symbol('flag')]: true }
};
const cloned = structuredClone(obj);
console.log(cloned); // { name: 'Alice', meta: {} }
// Symbol('id') 键消失，meta 中的 Symbol('flag') 值也被忽略

替代方案：需要 Symbol 时别用 structuredClone

若业务逻辑依赖 Symbol 键或 Symbol 值（例如私有元数据、内部状态标记），structuredClone 不适用。可考虑：

手动浅层处理：先 structuredClone 基础对象，再用 Object.getOwnPropertySymbols() 提取原对象的 Symbol 键，逐个赋值到克隆体（仅适用于 Symbol 作为属性键，且值本身可安全复用）；
自定义深拷贝函数：使用递归 + Reflect.ownKeys() 遍历所有键（含 Symbol），对 Symbol 值做特殊判断（如保留引用、替换为占位符、或抛出提示）；
改用 WeakMap / 元数据分离：把 Symbol 相关数据从对象本身剥离，用 WeakMap 存储关联关系，避免拷贝时丢失；
避免在可克隆对象中使用 Symbol：将 Symbol 改为字符串键（如 '__internal_id'），或仅在不可序列化场景（如类实例内部）使用 Symbol。