Symbol是JavaScript中唯一且不可变的原始值，核心用途是创建不与其他键冲突的对象属性名；每次Symbol()调用返回全新值，需用方括号访问，不参与常规枚举；Symbol.for()支持跨上下文共享，Symbol.toStringTag等内置Symbol用于定制对象行为协议。

Symbol 是 JavaScript 中唯一且不可变的原始值

它最核心的用途是创建不会与其他任何键冲突的对象属性名，尤其适合库作者或框架开发者避免命名污染。普通字符串键哪怕再长、再随机，理论上都可能撞车；而 Symbol() 每次调用都返回一个全新、不相等的值，连 === 都不成立。

用 Symbol 创建唯一对象键的正确方式

直接把 Symbol() 赋给对象属性即可，但要注意：它不会出现在 for...in、Object.keys() 或 JSON.stringify() 中，属于“隐藏但可访问”的键。

• 必须用方括号语法 obj[mySym] 访问，不能用点号 obj.mySym
• 若需调试时看到 Symbol 键，可用 Object.getOwnPropertySymbols(obj) 提取
• 重复调用 Symbol() 得到的是不同值，即使描述相同：Symbol('a') !== Symbol('a')

const sym1 = Symbol('id');
const sym2 = Symbol('id');
console.log(sym1 === sym2); // false

const user = {
  name: 'Alice',
  [sym1]: 1001
};
console.log(user[sym1]); // 1001
console.log(Object.keys(user)); // ['name']
console.log(Object.getOwnPropertySymbols(user)); // [Symbol(id)]

Symbol.for() 和 Symbol.keyFor()：跨执行上下文共享 Symbol

普通 Symbol() 全局唯一，但每次调用都新造一个；如果需要多个模块都能拿到同一个 Symbol（比如统一定义一个 “metadata” 键），就得用 Symbol.for(key) —— 它会先查全局注册表，有就返回，没有才新建。

• Symbol.for('debug') 和另一处同名调用返回的是同一个 Symbol
• Symbol.keyFor(sym) 只对 Symbol.for() 创建的 Symbol 有效，对普通 Symbol() 返回 undefined
• 注意命名空间污染风险：全局注册表是共享的，建议加前缀如 Symbol.for('mylib:cache')

const s1 = Symbol.for('state');
const s2 = Symbol.for('state');
console.log(s1 === s2); // true

console.log(Symbol.keyFor(s1)); // 'state'
console.log(Symbol.keyFor(Symbol('state'))); // undefined

Symbol.toStringTag 和其他内置 Symbol 的实际作用

这些是 JavaScript 引擎预留的“钩子”，用于定制对象在类型检测或字符串化时的行为。比如 Symbol.toStringTag 控制 Object.prototype.toString.call(obj) 的输出，常被用来伪装类名或兼容旧代码。

• Symbol.iterator 让对象可被 for...of 遍历，必须返回一个迭代器对象
• Symbol.hasInstance 自定义 instanceof 判断逻辑
• 它们不是“键名工具”，而是行为协议，误当普通 Symbol 用会导致功能失效

class MyList {
  constructor(items) {
    this.items = items;
  }
  get [Symbol.toStringTag]() {
    return 'MyList';
  }
}
console.log(Object.prototype.toString.call(new MyList([1,2]))); // '[object MyList]'