Symbol 是 JavaScript 原生原始类型，每次调用 Symbol() 都返回全新且不相等的值，因其不可复现性天然适合作为对象唯一键，避免属性名冲突。

Symbol 是什么，为什么它能当唯一键

Symbol 是 JavaScript 原生的原始类型，每次调用 Symbol() 都返回一个**全新且不相等**的值，哪怕描述相同：Symbol('a') !== Symbol('a')。它不是字符串，也不可转换为数字，只可显式转为字符串（String(sym) 或 sym.toString()）。正因这种“不可复现性”，它天然适合做对象属性的唯一键——不会意外覆盖已有属性，也避免了字符串键名冲突。

创建 Symbol 键的三种常见方式

实际使用中要区分场景，选对创建方式：

• Symbol()：最常用，生成完全独立、全局隔离的键。适合私有属性或模块内唯一标识，比如：

  const id = Symbol();
  const user = { [id]: 123 }; // 外部无法通过字符串访问

• Symbol.for(key)：在全局符号注册表中查找或创建。相同 key 总返回同一个 Symbol，适合跨模块共享键（如自定义事件类型）：

  Symbol.for('click') === Symbol.for('click') // true

• Symbol.keyFor(sym)：仅对 Symbol.for() 创建的 Symbol 有效，返回其注册时用的字符串键；对 Symbol() 直接调用返回 undefined。

Symbol 作为对象键的注意事项

Symbol 键不会出现在 for...in、Object.keys()、Object.getOwnPropertyNames() 中，但会被 Object.getOwnPropertySymbols() 和 Reflect.ownKeys() 捕获：

const sym = Symbol('hidden');
const obj = { a: 1, [sym]: 'secret' };

Object.keys(obj) // ['a']
Object.getOwnPropertySymbols(obj) // [Symbol(hidden)]
Reflect.ownKeys(obj) // ['a', Symbol(hidden)]

这意味着 Symbol 键是“半隐藏”的——不干扰常规遍历，但依然可被有意访问。若真要彻底私有，需配合 WeakMap 使用，而非直接挂载到对象上。

容易踩的坑：JSON 序列化和隐式转换

Symbol 值不能被 JSON.stringify() 序列化，会直接忽略该属性（不报错，也不提示）：

JSON.stringify({ [Symbol('x')]: 'nope', y: 2 }) // '{"y":2}'

同样，任何尝试将 Symbol 用于算术运算、模板字符串插值（未显式转字符串）、或作为 switch 的 case 值，都会抛 TypeError。唯一安全的隐式转换是拼接字符串：`prefix ${sym}` 会自动调用 sym.toString()，但结果形如 "Symbol(description)"，不是原始 symbol 值本身。

Symbol 的“唯一性”只在生成逻辑层面成立；真正决定它是否安全的关键，是你是否控制了 Symbol 的创建时机和作用域。混用 Symbol() 和 Symbol.for()、或误以为 Symbol 能绕过所有反射 API，是最常被忽略的复杂点。