Symbol 是 JS 中唯一且不可变的原始值，每次调用 Symbol() 都返回独一无二的值，用于解决属性名冲突和私有标识问题；它不可枚举、不被 JSON 序列化，仅能通过 Object.getOwnPropertySymbols() 访问。
Symbol 是什么：JS 中唯一且不可变的原始值
Symbol 是 JavaScript 的第七种原始类型（其余为 string、number、boolean、null、undefined、bigint），它的核心价值在于「每次调用 Symbol() 都返回一个独一无二的值」——哪怕描述相同，两个 Symbol 也绝不相等。
它不是用来替代字符串或数字的，而是解决「属性名冲突」和「私有/内部标识」这类问题的底层机制。比如你无法通过 for...in 或 Object.keys() 枚举到 Symbol 键，这使它天然适合做“隐藏但可访问”的属性名。
如何创建 Symbol：带描述 vs 不带描述的区别
Symbol 必须用函数调用方式创建，不能加 new，否则报 TypeError: Symbol is not a constructor。描述（description）参数是可选字符串，仅用于调试显示，不影响唯一性。
-
Symbol('foo')和Symbol('foo')是两个完全不同的值，===返回false - 空描述
Symbol()和Symbol('')也不相等 - 描述会被转为字符串，
Symbol(42)等价于Symbol('42')
const s1 = Symbol('id');
const s2 = Symbol('id');
console.log(s1 === s2); // false
console.log(s1.toString()); // "Symbol(id)"
console.log(Symbol(123).toString()); // "Symbol(123)"
Symbol.for() 和 Symbol.keyFor()：全局注册表的例外
普通 Symbol() 总是唯一的，但 Symbol.for(key) 会先检查全局 Symbol 注册表中是否已有该 key 对应的 Symbol；有则返回，无则新建并登记。这意味着它打破了“每次必唯一”的规则，但提供了跨模块共享 Symbol 的能力。
立即学习“Java免费学习笔记（深入）”；
-
Symbol.for('debug')多次调用返回同一个 Symbol -
Symbol.keyFor(sym)只对通过Symbol.for()创建的 Symbol 有效，对普通 Symbol 返回undefined - 全局注册表是全局环境共享的，Node.js 模块间、iframe 间都可见
const a = Symbol.for('shared');
const b = Symbol.for('shared');
console.log(a === b); // true
const c = Symbol('shared');
console.log(Symbol.keyFor(c)); // undefined
console.log(Symbol.keyFor(a)); // "shared"
Symbol 作为对象属性键：枚举性与访问限制
Symbol 可以作为对象属性键使用，但它的行为和字符串键完全不同：它不会出现在 Object.keys()、Object.getOwnPropertyNames() 或 JSON.stringify() 中，只能通过 Object.getOwnPropertySymbols() 或 Reflect.ownKeys() 获取。
- 用
obj[sym] = value赋值后，必须用同个 Symbol 实例才能读取 - Symbol 键属性默认是“不可枚举”的，但它是可配置、可写的（除非显式
Object.defineProperty修改） - ES6 内置大量知名 Symbol（如
Symbol.iterator、Symbol.toStringTag），用于定制对象行为
const sym = Symbol('hidden');
const obj = { [sym]: 'secret', name: 'alice' };
console.log(Object.keys(obj)); // ['name']
console.log(Object.getOwnPropertySymbols(obj)); // [Symbol(hidden)]
console.log(obj[sym]); // 'secret'
console.log(JSON.stringify(obj)); // {"name":"alice"}
Symbol 的“唯一性”只在手动创建时成立；一旦用了 Symbol.for() 或复用已有 Symbol 实例，就变成可预测的标识符了。真正容易忽略的是：它不参与常规属性遍历，也不被序列化——如果你依赖 for...in 或深拷贝工具同步 Symbol 属性，大概率会漏掉。 
