symbol是javaScript中唯一绝对不冲突的原始类型,用作私有属性键可避免覆盖和遍历暴露;Symbol()每次生成唯一值,Symbol.for()实现跨模块共享,内置Symbol如Symbol.iterator可定制语言行为。

Symbol 是 javascript 中唯一能保证“绝对不冲突”的原始类型,不是用来存数据的,而是用来当“钥匙”——开特定的门,且这把钥匙别人造不出来。
为什么不能用字符串当属性名?
当你往一个对象上加扩展字段(比如插件、日志标记、内部状态),用字符串键很容易被覆盖或误读:
-
obj.id和obj['id']看似安全,但第三方库也可能写obj.id = ...,直接覆盖 -
for...in、Object.keys()、jsON.Stringify()全都能看到它,隐私性为零 - “魔术字符串”如
'cache_key'散落在代码各处,改起来容易漏、难搜索
而 Symbol() 每次调用都返回一个全新值,哪怕描述一样:
const a = Symbol('id'); const b = Symbol('id'); console.log(a === b); // false
怎么用 Symbol 做真正隔离的属性?
把它当计算属性名用,就能躲过常规遍历和序列化:
- 必须用方括号访问:
obj[mySym],不能用点号obj.mySym -
Object.keys(obj)、for...in、json.stringify()都看不到它 - 想查它?得用专门方法:
Object.getOwnPropertySymbols(obj) - 注意:它不是私有(
Reflect.ownKeys()和getOwnPropertySymbols()都能拿到),只是“不显眼”
const _internal = Symbol('internal'); const user = { name: 'Alice' }; user[_internal] = { lastLogin: Date.now() }; console.log(user[_internal]); // { lastLogin: 1736726... } console.log(Object.keys(user)); // ['name'] console.log(Object.getOwnPropertySymbols(user)); // [Symbol(internal)]
什么时候需要全局唯一的 Symbol?用 Symbol.for()
单个模块里用 Symbol() 没问题,但跨文件/跨包想共享同一个 Symbol 键,就得走全局注册表:
立即学习“Java免费学习笔记(深入)”;
-
Symbol.for('logger')第一次调用会创建并登记;之后再调用同名,返回同一个值 -
Symbol.keyFor(sym)只对Symbol.for()创建的 Symbol 有效,普通Symbol()返回undefined - 全局 Symbol 本质是字符串到 Symbol 的映射,所以 key 会被强制转成字符串
const s1 = Symbol.for('debug'); const s2 = Symbol.for('debug'); console.log(s1 === s2); // true console.log(Symbol.keyFor(s1)); // 'debug' console.log(Symbol.keyFor(Symbol('debug'))); // undefined
内置 Symbol 是怎么改变语言行为的?
JavaScript 用一些固定名称的 Symbol(如 Symbol.iterator)作为协议入口,你实现它,就能接管原生语法的行为:
-
Symbol.iterator→ 让对象支持for...of和展开运算符[...obj] -
Symbol.toStringTag→ 改变Object.prototype.toString.call(obj)的输出标签 -
Symbol.hasInstance→ 自定义instanceof判断逻辑 - 这些 Symbol 不是你“随便起名”的,必须用标准名,否则引擎不识别
const myArrayLike = { 0: 'a', 1: 'b', length: 2, [Symbol.iterator]: function* () { for (let i = 0; i < this.length; i++) yield this[i]; } }; console.log([...myArrayLike]); // ['a', 'b']
最容易被忽略的一点:Symbol 值不能隐式转换成字符串——'' + sym 会报错,必须显式调用 sym.toString() 或 String(sym)。这点在调试和日志中常踩坑。