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 时,可用全局注册表:
立即学习“Java免费学习笔记(深入)”;
-
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判断逻辑 - 这些是语言级钩子,开发者可实现它们来扩展原生语法能力











