structuredClone 丢弃 Symbol 是因其不可序列化，HTML 标准明确排除；示例中 Symbol 键值均消失；替代方案包括手动处理、自定义深拷贝、WeakMap 分离或改用字符串键。
structuredClone 无法拷贝 Symbol 类型，它会直接丢弃（忽略）所有 Symbol 键和 Symbol 值，且不报错。
为什么 Symbol 会被丢弃？
structuredClone 遵循 HTML 标准的结构化克隆算法，该算法只支持可序列化的数据类型。Symbol 是不可序列化的原始值——它没有字面量表示，不能被 JSON 化，也没有跨上下文唯一标识机制（即使同名 Symbol 也互不相等），因此被明确排除在克隆范围之外。
实际表现示例
以下代码中，Symbol 键和 Symbol 值均不会出现在克隆结果中：
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 不适用。可考虑：
立即学习“Java免费学习笔记（深入）”；
- 手动浅层处理：先 structuredClone 基础对象，再用 Object.getOwnPropertySymbols() 提取原对象的 Symbol 键，逐个赋值到克隆体（仅适用于 Symbol 作为属性键，且值本身可安全复用）；
- 自定义深拷贝函数：使用递归 + Reflect.ownKeys() 遍历所有键（含 Symbol），对 Symbol 值做特殊判断（如保留引用、替换为占位符、或抛出提示）；
- 改用 WeakMap / 元数据分离：把 Symbol 相关数据从对象本身剥离，用 WeakMap 存储关联关系，避免拷贝时丢失；
- 避免在可克隆对象中使用 Symbol：将 Symbol 改为字符串键（如 '__internal_id'），或仅在不可序列化场景（如类实例内部）使用 Symbol。
小结
structuredClone 的设计目标是安全、高效、跨上下文的数据传递，不是通用深拷贝工具。Symbol 因其不可序列化本质被主动排除。需要 Symbol 支持，就得放弃 structuredClone，选择更可控的手动方案。
