symbol 是 javaScript 的原始类型,用于创建唯一不可变标识符;它解决属性名冲突、支持全局注册表(Symbol.for)、启用内置协议(如 Symbol.iterator),但非真正私有。

Symbol 是 javascript 中的原始类型,用来创建唯一、不可变的标识符
它不是字符串,也不是对象,而是一种全新的原始类型(和 String、number 并列)。每次调用 Symbol() 都会返回一个**全新且不相等**的值,哪怕描述相同:
Symbol('foo') === Symbol('foo') // false
这种天然唯一性,让它成为解决「属性名冲突」和「私有属性模拟」问题的核心工具。
Symbol 解决了对象属性名被意外覆盖的问题
在没有 Symbol 之前,多人协作或引入第三方库时,很容易因使用相同字符串键名导致覆盖。比如两个模块都往 obj 上加 id 或 cache 字段,谁后写谁赢。
用 Symbol 就能隔离:
const CACHE_KEY = Symbol('cache');
const ID_KEY = Symbol('id');
obj[CACHE_KEY] = new Map();
obj[ID_KEY] = 123;
// 其他代码无法通过字符串 'cache' 访问到它,也不会被覆盖
注意:Symbol 属性不会出现在 for...in、Object.keys()、jsON.stringify() 中,但可通过 Object.getOwnPropertySymbols() 获取。
全局 Symbol 注册表:Symbol.for() 和 Symbol.keyFor()
普通 Symbol() 每次都新造,但有时需要跨模块共享同一个 Symbol —— 这就得用全局注册表:
-
Symbol.for('myKey')会先查全局池,存在就返回,否则新建并登记 -
Symbol.keyFor(sym)可反查该 Symbol 是否来自注册表及其键名 - 注意:
Symbol.for('a') !== Symbol('a'),后者是匿名独立 Symbol
这在实现插件系统、框架级钩子(如 react 的 Symbol.for('react.element'))时很关键。
内置 Symbol(如 Symbol.iterator)让自定义类型支持语言语法
JavaScript 引擎会识别特定名称的 Symbol 属性,赋予对象语言级能力。最典型的是:
-
[Symbol.iterator]:让对象可用for...of遍历 -
[Symbol.toStringTag]:影响Object.prototype.toString.call(obj)输出 -
[Symbol.hasInstance]:定制instanceof行为
这些不是“魔法”,而是引擎约定俗成的协议入口点。你只要在对象上定义对应 Symbol 方法,就能接入原生语法支持,不需要改语言本身。
立即学习“Java免费学习笔记(深入)”;
真正容易忽略的是:Symbol 属性虽“隐藏”,但并非真正私有 —— 它仍可被 Object.getOwnPropertySymbols() 或 Reflect.ownKeys() 暴露。如果真要封装,得配合闭包或 WeakMap;Symbol 更适合做「防误撞」而非「防访问」。