Symbol 是 JavaScript 中用于创建唯一不可变值的原始类型,主要解决对象属性名冲突问题;其核心特性为唯一性、私密性及预定义符号对对象行为的定制能力。
Symbol 是 JavaScript 中一种原始数据类型,用来创建唯一且不可变的值,主要解决对象属性名冲突问题。
Symbol 的核心特点:唯一性与私密性
每次调用 Symbol() 都会返回一个全新的、与其他所有 Symbol 值不相等的值(即使描述相同):
-
Symbol('a') !== Symbol('a')—— 两个同名 Symbol 依然不等 -
Symbol.for('a') === Symbol.for('a')—— 全局注册表中才可复用(需主动使用Symbol.for) - Symbol 值不能参与运算或隐式转换,
String(sym)或sym.toString()才能转为字符串
作为对象属性键:避免命名冲突
把 Symbol 当作属性名,能防止意外覆盖或被枚举到:
- 对象中用
obj[mySym] = 'secret'定义属性,该属性不会出现在for...in、Object.keys()、JSON.stringify()中 - 但可通过
Object.getOwnPropertySymbols(obj)获取所有 Symbol 属性 - 适合实现“弱公开”内部字段,比如类的私有状态标识:
class Counter { constructor() { this[Counter._count] = 0; } }
预定义 Symbol(Well-known Symbols):定制对象行为
ES6 提供一组内置 Symbol,用于自定义对象在特定场景下的表现:
-
Symbol.iterator:让对象支持for...of和扩展运算符(如实现自定义迭代器) -
Symbol.toStringTag:影响Object.prototype.toString.call(obj)的返回结果(如class A { [Symbol.toStringTag] = 'MyClass'; }→[object MyClass]) -
Symbol.hasInstance:重写instanceof的判断逻辑 -
Symbol.toPrimitive:控制对象转原始值时的行为(如 +、==、String() 等场景)
不是真正的“私有”,但提供了可控的封装边界
Symbol 属性不是完全隐藏的 —— 它们可被反射 API(如 getOwnPropertySymbols)发现,也不阻止调试或动态访问。但它明确传递了“这个属性是内部用途”的意图,比用下划线约定更可靠、更规范。
基本上就这些。Symbol 不复杂,但
容易忽略它在设计健壮 API 和避免污染时的实际价值。








