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。
这本书并不是一本语言参考书,但它是一个Android开发者去学习Kotlin并且使用在自己项目中的一个工具。我会通过使用一些语言特性和有趣的工具和库来解决很多我们在日常生活当中都会遇到的典型问题。 这本书是非常具有实践性的,所以我建议你在电脑面前跟着我的例子和代码实践。无论何时你都可以在有一些想法的时候深入到实践中去。 这本书适合你吗? 写这本书是为了帮助那些有兴趣 使用Kotlin语言来进行开发的Android开发者。 如果你符合下面这些情况,那这本书是适合你的: 你有相关Android开发和Andro
立即学习“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 对象模型里最冷静的一把钥匙。










