17370845950

Symbol 是 JavaScript 的第七种原始类型，每次调用 Symbol() 都返回独一无二、不可重复创建的值，核心用途是作为安全防冲突的对象属性键或内置方法钩子。

Symbol 是什么：JavaScript 中的原始类型唯一值

Symbol 是 JavaScript 的第七种原始类型（其余为 string、number、boolean、null、undefined、bigint），它每次调用 Symbol() 都会返回一个**独一无二、不可被重复创建**的值。它不是对象，不能用 new 调用，也不支持属性赋值（比如 sym.foo = 1 会静默失败）。

它的核心用途不是“标识字符串”，而是作为**安全的、防冲突的键名**，尤其用于对象属性或内置方法的定制钩子（如 Symbol.iterator）。

如何创建 Symbol：带描述 vs 不带描述，全局注册 vs 局部唯一

Symbol 创建有三种常见方式，关键区别在于「是否可复用」和「是否跨执行上下文共享」：

• Symbol('desc')：每次调用都生成新值，即使描述相同 —— 最常用，用于私有/局部唯一键
• Symbol.for('key')：在全局 Symbol 注册表中查找或创建；同一字符串多次调用返回同一个 Symbol —— 用于跨模块/跨 iframe 共享标识符
• Symbol.keyFor(sym)：仅对 Symbol.for() 创建的 Symbol 有效，返回其注册时用的字符串键；对普通 Symbol() 返回 undefined

示例对比：

const a = Symbol('id');
const b = Symbol('id');
console.log(a === b); // false —— 描述相同，值不同

const x = Symbol.for('shared');
const y = Symbol.for('shared');
console.log(x === y); // true —— 全局注册，值相同

console.log(Symbol.keyFor(x)); // 'shared'
console.log(Symbol.keyFor(a)); // undefined

Symbol 作为对象属性键：隐藏但可枚举？

Symbol 可以作为对象属性名使用，且天然避免命名冲突。但它不会出现在 for...in、Object.keys() 或 JSON.stringify() 中，属于「非字符串键」的特殊存在：

• Object.getOwnPropertyNames(obj)：只返回字符串键，不包含 Symbol 键
• Object.getOwnPropertySymbols(obj)：专门获取所有 Symbol 类型的自有属性键
• Reflect.ownKeys(obj)：同时返回字符串键 + Symbol 键（ES2015+ 推荐用法）

示例：

const sym1 = Symbol('hidden');
const sym2 = Symbol('meta');
const obj = {
  name: 'Alice',
  [sym1]: 42,
  [sym2]: { version: 1 }
};

console.log(Object.keys(obj)); // ['name']
console.log(Object.getOwnPropertySymbols(obj)); // [Symbol(hidden), Symbol(meta)]
console.log(Reflect.ownKeys(obj)); // ['name', Symbol(hidden), Symbol(meta)]

容易踩的坑：类型转换、相等判断与 JSON 序列化

Symbol 无法隐式转为字符串或数字，任何强制转换都会报错：

• String(sym) ✅ 可行（返回 "Symbol(desc)"）
• sym + '' ❌ 报 TypeError: Cannot convert a Symbol value to a string
• Number(sym) ❌ 同样报错
• JSON.stringify({ key: Symbol('x') }) → {}（Symbol 键被完全忽略）
• 两个 Symbol 永远不相等，除非是同一个引用（=== 判断）或同属 Symbol.for() 注册表

真正需要“唯一标识符”的场景（比如缓存 key、私有状态容器），别用字符串拼接或时间戳，直接用 Symbol()；若需跨环境一致，才考虑 Symbol.for() —— 但得小心全局污染风险。