UD5工具箱
Symbol 创建器
通过简洁的输入框即可创建一个新的 Symbol 实例。支持为 Symbol 附加可选的描述字符串，帮助您理解描述在调试输出和 description 属性中的呈现方式。每次点击创建按钮，控制台都会生成一个全新的、不可重复的唯一标识符。工具会实时显示 Symbol 的字符串表示形式（如 Symbol(myKey)），让您直观感受 Symbol 的输出格式。创建器还会提示用户：new Symbol() 会抛出 TypeError，正确的方式是直接调用 Symbol()。通过反复创建带有相同和不同描述的 Symbol，您可以深刻理解「即使描述相同，Symbol 依然不相等」这一核心特性，为后续的对比实验打下基础。
属性详情面板
创建 Symbol 后，工具会即时展示其完整属性信息：包括 typeof 类型检测结果（始终为 "symbol"，注意全小写）、description 描述字符串（若创建时未传入则显示 undefined）、原始值的字符串表示形式（格式为 Symbol(description)），以及该 Symbol 是否通过 Symbol.for() 注册到全局符号注册表。这些信息以清晰的键值对形式呈现，帮助您全面了解 Symbol 的内部状态。面板还会显示 Symbol 的属性长度、是否可转换为原始值等附加信息，让您对这个数据类型有更完整的认知。每次创建新 Symbol 时，面板会自动刷新，确保展示的始终是当前活跃 Symbol 的最新状态。
唯一性对比实验
这是理解 Symbol 最重要的实验模块。您可以创建两个带有完全相同描述字符串的 Symbol，然后使用严格相等运算符（===）进行对比。工具会直观地展示对比结果 —— 无论描述是否相同，两个独立创建的 Symbol 永远不相等。这与对象的引用比较有着本质区别：两个相同内容的对象不相等是因为它们指向不同的引用，而两个 Symbol 不相等是因为它们本身就是不同的值。工具还提供了多组对比场景：同描述 Symbol 对比、异描述 Symbol 对比、Symbol 与字符串的类型对比等。通过这些实验，您将深刻理解 Symbol 作为「唯一标识符」的根本保证——这种唯一性是语言层面的硬性约束，而非依赖于某种约定或配置。
Symbol.for() 全局注册表
通过 Symbol.for() 方法创建的 Symbol 会被存储在全局符号注册表中，任何代码都可以通过相同的键值访问同一个 Symbol。工具提供独立的操作面板，让您体验全局 Symbol 与普通 Symbol 的本质区别：同名的全局 Symbol 指向同一个引用，而同名的普通 Symbol 则各自独立。面板会展示注册表的工作流程——先查找、再创建的惰性初始化机制。您还可以尝试在不同「上下文」中使用 Symbol.for() 创建同名 Symbol，观察它们是否相等。这种机制在跨模块、跨 iframe 甚至跨 Web Worker 的场景中具有重要实用价值，是构建插件系统和微前端架构时的关键通信手段。工具还会展示 Symbol.keyFor() 方法，帮助您理解如何从全局 Symbol 反向获取其注册键。
对象属性键演示
Symbol 最重要的实际用途之一是作为对象的属性键。工具提供了交互式的属性键演示，展示如何使用 Symbol 避免属性冲突。您可以为同一个对象同时添加字符串键和 Symbol 键，并观察 Object.keys()、Object.getOwnPropertyNames()、Object.getOwnPropertySymbols() 和 Reflect.ownKeys() 等方法对两类键的不同处理方式。演示还包含了实际场景模拟：假设两个第三方库各自使用 Symbol 为同一个对象添加属性，观察它们如何互不干扰地共存。这直观地展示了 Symbol 属性「不可枚举」的设计意图——Symbol 属性是为内部协议和元数据准备的，不应该影响对象的常规遍历和序列化行为。
著名 Symbol 探索
JavaScript 内置了一系列著名 Symbol（Well-Known Symbols），它们驱动着语言的核心协议。工具提供了对以下著名 Symbol 的交互式演示：Symbol.iterator——定义对象的同步迭代行为，使对象支持 for...of 循环和展开运算符；Symbol.asyncIterator——定义异步迭代行为，使对象支持 for await...of 循环；Symbol.toStringTag——自定义 Object.prototype.toString() 的返回值，影响类型标签的显示；Symbol.hasInstance——自定义 instanceof 运算符的行为逻辑；Symbol.toPrimitive——自定义对象在隐式类型转换为原始值时的转换逻辑；Symbol.species——指定派生构造函数，影响内置方法（如 map()、filter()）的返回类型。通过修改对象的这些 Symbol 属性，您可以实时观察自定义迭代行为、类型转换逻辑和类继承模式的变化，深入理解 JavaScript 的元编程机制。
JSON 序列化行为演示
工具还特别演示了 Symbol 在 JSON.stringify() 处理下的行为。由于 Symbol 既不是字符串也不是数字，它会被 JSON 序列化过程完全忽略。演示分为三个场景：直接对 Symbol 值调用 JSON.stringify()（返回 undefined）、对包含 Symbol 值属性的对象进行序列化（Symbol 属性被跳过）、对包含 Symbol 键属性的对象进行序列化（整个键值对被跳过）。此外，工具还展示了 JSON.stringify() 与 toJSON() 方法的配合使用，以及如何通过 replacer 参数或自定义序列化函数来处理 Symbol 数据。这一功能对于理解数据持久化和网络传输中的序列化陷阱非常有帮助，尤其是在使用 RESTful API 或 WebSocket 传输复杂对象时。
Symbol 属性复制与克隆
当您需要复制或克隆包含 Symbol 属性的对象时，常规的 Object.assign() 或扩展运算符 {...obj} 只能复制字符串键属性，Symbol 属性会被遗漏。工具提供了专门的演示模块，展示正确的 Symbol 属性复制方式：使用 Object.getOwnPropertySymbols() 遍历 Symbol 键并逐个赋值。同时，工具还演示了 structuredClone()（结构化克隆算法）对 Symbol 属性的处理行为，以及 Reflect API 在属性复制中的应用。这些演示帮助开发者在实际项目中避免因忽略 Symbol 属性而导致的数据丢失问题，是前后端数据交互场景中非常实用的知识点。