Symbol 是 JavaScript 中具有唯一性的原始数据类型，每次调用 Symbol() 都返回内存身份不同的新值，即使描述相同；常作对象私有属性键避免命名冲突，支持全局注册表 Symbol.for 实现跨文件共享，用于私有字段、行为定制及状态标识等场景。
Symbol 是 JavaScript 中一种原始数据类型，它的核心特征是“唯一性”——每次调用 Symbol() 都会返回一个全新的、与其他任何 Symbol 值都不相等的值，即使描述相同。
Symbol 的唯一性从何而来
Symbol 不是通过字符串比较来判断相等，而是基于内存中的身份（identity）。即便两个 Symbol 使用相同的描述字符串创建，它们也互不相等：
const s1 = Symbol('foo');<br>const s2 = Symbol('foo');<br>console.log(s1 === s2); // false<br>console.log(s1.toString()); // "Symbol(foo)"<br>console.log(s2.toString()); // "Symbol(foo)"
这种唯一性由引擎底层保证，无法被模拟或绕过，是 Symbol 区别于字符串和数字的根本所在。
立即学习“Java免费学习笔记（深入）”；
作为对象属性键：避免命名冲突
Symbol 常被用作对象的“私有”或“内部”属性键，防止外部代码意外覆盖或干扰：
- 定义一个 Symbol 作为方法标识符，确保不会与用户传入的普通字符串键冲突
- 多个模块/库可各自使用 Symbol 添加功能属性，互不影响
- ES6 内置方法如
Symbol.iterator、Symbol.toStringTag就是典型应用
const COUNT = Symbol('count');<br>const obj = {<br> name: 'Alice',<br> [COUNT]: 0,<br> increment() { this[COUNT]++; }<br>};<br>// 外部遍历（for...in / Object.keys）不会暴露 COUNT 属性<br>console.log(Object.keys(obj)); // ['name']<br>console.log(Reflect.ownKeys(obj)); // ['name', Symbol(count)]
全局 Symbol 注册表：实现跨文件唯一共享
如果需要“相同描述对应同一个 Symbol”，可使用 Symbol.for(key)。它会检查全局注册表，已存在则复用，否则新建并登记：
-
Symbol.for('debug')和另一处同名调用返回完全相同的 Symbol - 配合
Symbol.keyFor(sym)可反向查出注册时用的 key - 适合框架级标识（如自定义事件类型、调试钩子、插件协议）
const s1 = Symbol.for('state');<br>const s2 = Symbol.for('state');<br>console.log(s1 === s2); // true<br>console.log(Symbol.keyFor(s1)); // "state"
实际开发中的典型用途
- 实现轻量级私有字段：在类中用 Symbol 存储不应被枚举或外部修改的状态
-
定制对象行为：通过
Symbol.toPrimitive控制隐式类型转换，Symbol.hasInstance自定义instanceof判断逻辑 -
状态机或枚举标识：替代字符串常量，杜绝拼写错误导致的逻辑错误（如
status: STATUS.LOADING中 STATUS 是 Symbol 构建的对象） -
第三方库扩展点：如 React 使用
Symbol.for('react.element')标识合法的 JSX 元素对象
Symbol 的设计初衷不是替代字符串，而是提供一种可控、不可伪造、天然隔离的标识机制。合理使用能提升代码健壮性和协作清晰度。
