symbol 是 js 中唯一能创建“真正私有属性”的原语,专治对象属性名冲突,通过唯一性、不可枚举性和协议化设计实现可控暴露与命名隔离。

Symbol 是 JS 中唯一能创建“真正私有属性”的原语
它不解决“数据封装”的通用需求,而是专治对象属性名冲突——尤其是第三方库、框架或跨模块协作时,你无法控制别人往 Object.prototype 或某个共享对象上加什么键。
比如两个库都定义了 cache 属性,又都用 obj.cache = {},必然覆盖。用 Symbol('cache') 就能天然隔离,因为每次调用都返回新值,且不参与枚举、json.stringify、for...in 等常规遍历。
-
Symbol()每次返回的值严格不相等(Symbol() !== Symbol()),哪怕描述相同 -
Symbol.for('key')才是全局注册表:相同字符串返回同一个 Symbol,适合跨模块通信 - 对象属性名用 Symbol 时,必须用方括号访问:
obj[mySym] = 'value',点号无效
Symbol 作为对象内部状态的“隐藏句柄”
很多内置方法依赖 Symbol 做协议钩子,比如 Symbol.iterator 让对象可被 for...of 遍历,Symbol.toStringTag 控制 Object.prototype.toString.call(obj) 的输出。
这些不是约定俗成的字符串键,而是硬编码识别的 Symbol——你用字符串 'iterator' 完全没用,必须用 Symbol.iterator。
立即学习“Java免费学习笔记(深入)”;
- 自定义迭代器必须挂在
[Symbol.iterator]上,否则for...of不认 -
Symbol.toPrimitive决定对象在 +、== 等运算中转成什么原始值 - 这些 Symbol 是语言级契约,不可替代,也不可模拟
为什么不用 WeakMap 或闭包代替 Symbol?
WeakMap 能存私有数据,闭包也能封住变量,但它们解决的是“值私有”,而 Symbol 解决的是“键私有”。关键区别在于:Symbol 作为属性名,仍属于对象自身,可被 Object.getOwnPropertySymbols() 获取,也参与原型链查找;WeakMap 则完全脱离对象结构,靠引用绑定。
- 想让属性出现在
Object.keys(obj)之外,但仍在Object.getOwnPropertyNames(obj)之外 → 用 Symbol - 想彻底隐藏数据,连调试时都不希望被反射到 → 用 WeakMap 或闭包
- Symbol 属性会被
Object.assign({}, obj)忽略,但Reflect.ownKeys(obj)能拿到它
const sym1 = Symbol('id'); const sym2 = Symbol('id'); const obj = { [sym1]: 123, name: 'test' }; console.log(sym1 === sym2); // false console.log(Object.keys(obj)); // ['name'] console.log(Reflect.ownKeys(obj)); // ['name', Symbol(id)] console.log(obj[sym1]); // 123 console.log(obj.sym1); // undefined —— 点号访问不了 Symbol 键
Symbol 的真实价值不在“私有”,而在“可控暴露”:它让你在开放对象结构的同时,避开命名污染,同时为语言机制提供稳定、不可伪造的协议入口。别把它当黑魔法,它是 JS 对象模型里最冷静的一把钥匙。