17370845950

Symbol 是 JavaScript 中唯一且不可变的原始类型，用于创建不冲突的对象属性名；支持匿名/带描述创建、私有属性隐藏、全局注册表共享及内置 Symbol 协议扩展。

Symbol 是 JavaScript 中一种原始数据类型，专门用来创建唯一、不可变的标识符，主要解决对象属性名冲突问题。 它不是字符串，也不等于任何其他值（包括另一个同名 Symbol），每次调用 Symbol() 都会生成一个全新的、独一无二的值。

Symbol 的基本创建方式

最常用的是直接调用 Symbol() 函数：

• const id1 = Symbol(); —— 创建一个匿名 Symbol，值唯一但无描述
• const id2 = Symbol('user_id'); —— 创建带描述的 Symbol，描述仅用于调试，不影响唯一性
• const id3 = Symbol('user_id'); —— 即使描述相同，id2 !== id3，仍为不同值

Symbol 作为对象属性名的特殊用途

Symbol 最核心的用途是定义“私有”或“内部”属性，避免被意外覆盖或枚举：

• 用作对象键时，该属性不会出现在 for...in、Object.keys()、JSON.stringify() 中
• 但仍可通过 Object.getOwnPropertySymbols() 获取
• 示例：
  

  const _name = Symbol('name');
  const user = { [_name]: 'Alice', age: 30 };
  console.log(user[_name]); // 'Alice'
  console.log(Object.keys(user)); // ['age']
  console.log(Object.getOwnPropertySymbols(user)); // [Symbol(name)]

全局 Symbol 注册表：Symbol.for() 和 Symbol.keyFor()

当需要跨模块共享同一个 Symbol 时，可用全局注册表：

• Symbol.for('debug') 查找已注册的 Symbol，未找到则新建并登记
• Symbol.for('debug') === Symbol.for('debug') 返回 true
• Symbol.keyFor(Symbol.for('debug')) 返回 'debug'
• 注意：Symbol('debug') !== Symbol.for('debug')，前者是局部唯一，后者是全局唯一

内置 Symbol 值与迭代协议支持

JavaScript 预定义了一批以 Symbol 开头的静态属性（如 Symbol.iterator），用于自定义对象行为：

• [Symbol.iterator]：让对象可被 for...of 遍历
• [Symbol.toStringTag]：影响 Object.prototype.toString.call(obj) 的输出
• [Symbol.hasInstance]：自定义 instanceof 判断逻辑
• 这些是语言级钩子，开发者可实现它们来扩展原生语法能力