Symbol 是 JavaScript 中唯一且不可变的原始类型,用于避免属性名冲突、模拟弱私有属性、替代字符串常量标识行为及控制对象内置行为。

Symbol 是 JavaScript 中一种原始数据类型,用来创建唯一、不可变的值。它不支持字面量写法,必须通过 Symbol() 函数生成;哪怕传入相同的描述字符串,每次调用也返回完全不同的值。
避免对象属性名冲突
多个模块或库向同一个对象添加属性时,用字符串作键容易覆盖。Symbol 作为键天然唯一,杜绝意外覆盖。
- 适合插件系统、混入(mixin)扩展对象等场景
- 示例:两个库都想加
id字段,用Symbol('id')各自定义,互不影响 - 注意:描述字符串仅用于调试显示,不影响唯一性
模拟弱私有属性
Symbol 键不会出现在 for...in、Object.keys() 或 JSON.stringify() 中,能隐藏内部状态。
- 常用于类中存储敏感字段,如账户余额、缓存标记
- 需将 Symbol 定义在模块作用域内,防止外部拿到引用
- 不是真正私有:仍可通过
Object.getOwnPropertySymbols()访问
替代字符串常量做行为标识
在状态机、action 类型、事件类型等场景中,用 Symbol 替代字符串可避免拼写错误和重复误判。
立即学习“Java免费学习笔记(深入)”;
- 例如 Redux action type:
const LOGIN = Symbol('LOGIN') - 比字符串更安全:
Symbol('LOGIN') !== 'LOGIN',也不会和别的字符串意外相等 - 配合
switch或Map使用更可靠
控制对象内置行为(知名 Symbol)
JavaScript 预定义了一批以 Symbol.xxx 形式存在的“知名 Symbol”,用于定制对象底层行为。
-
Symbol.iterator:让对象支持for...of和展开运算符 -
Symbol.toStringTag:影响Object.prototype.toString.call(obj)的输出 -
Symbol.hasInstance:自定义instanceof判断逻辑 - 这些是元编程的关键入口,属于语言级钩子










