Symbol是JavaScript中用于生成唯一不可变值的原始类型,主要作为对象属性键避免命名冲突;每次Symbol()调用均返回不同值,描述字符串仅用于调试;支持全局注册表Symbol.for()和内置Symbol扩展语言行为。

Symbol 是 JavaScript 中的一种原始数据类型,用来生成唯一且不可变的值。它最核心的作用,就是作为对象属性的键,避免命名冲突——尤其在多人协作或使用第三方库时,能确保你添加的属性不会意外覆盖已有属性。
Symbol 保证唯一性,每次调用都产生新值
即使传入相同的描述字符串,Symbol() 调用也总是返回不同的值:
let sym1 = Symbol('id');
let sym2 = Symbol('id');
console.log(sym1 === sym2); // false
这种“唯一性”不是靠字符串内容决定的,而是由引擎内部机制保障的。描述字符串(如 'id')仅用于调试时的标识,不影响相等性判断。
立即学习“Java免费学习笔记(深入)”;
用作对象属性键,避开属性名碰撞
普通字符串键容易重名,而 Symbol 键天然隔离:
- 多个模块各自用 Symbol 定义私有属性,互不干扰
- 框架可在对象上添加元信息(如
obj[Symbol.iterator]),不污染用户可见的属性列表 - Object.keys()、for...in 不会遍历 Symbol 键,保持接口干净
例如:const uid = Symbol('uid');
let user = { name: 'Alice', [uid]: 'a1b2c3' };
console.log(Object.keys(user)); // ['name'] —— uid 不出现
全局 Symbol 注册表:Symbol.for() 与 Symbol.keyFor()
如果需要跨文件共享同一个 Symbol,可用全局注册表:
let s1 = Symbol.for('shared');
let s2 = Symbol.for('shared');
console.log(s1 === s2); // true
Symbol.for() 先查全局表,存在则复用;Symbol.keyFor() 可反向查出注册时用的键名。注意:这和普通 Symbol 的唯一性逻辑不同,要按需选择。
内置 Symbol 值提供语言级扩展能力
JavaScript 预定义了一批以 Symbol 开头的全局变量(如 Symbol.iterator、Symbol.toStringTag),允许开发者自定义对象在特定场景下的行为:
- 实现
[Symbol.iterator](),让对象支持 for...of - 设置
[Symbol.toStringTag],改变 Object.prototype.toString.call(obj) 的输出 - 用
Symbol.hasInstance自定义 instanceof 判断逻辑
这些是语言留给开发者“插手底层机制”的标准入口,Symbol 类型正是承载这类能力的基础。










