Symbol 是 JavaScript 的原始类型,用于创建唯一不可变值以避免属性名冲突;其作为对象键时不可枚举但可通过 Object.getOwnPropertySymbols 获取,Symbol.for() 支持全局复用,但需慎用。

Symbol 是 JavaScript 中的原始类型,用于创建唯一、不可变的值,主要解决对象属性名冲突和私有属性模拟问题。
为什么需要 Symbol?——避免属性名意外覆盖
在对象中直接用字符串作为键时,不同模块或库可能无意中使用相同属性名,导致覆盖或行为异常。比如两个第三方工具都往 obj 上挂 "id" 或 "cache",就会互相干扰。
Symbol 保证每次调用 Symbol() 都返回一个**全新且唯一**的值,即使描述相同:
const s1 = Symbol('key');
const s2 = Symbol('key');
console.log(s1 === s2); // false
这种唯一性让开发者能安全地“预留”属性位置,不担心被其他代码污染。
立即学习“Java免费学习笔记(深入)”;
Symbol 作为对象属性键的特殊行为
用 Symbol 作对象属性键时,该属性不会出现在 for...in、for...of、Object.keys()、Object.getOwnPropertyNames() 中,但可通过 Object.getOwnPropertySymbols() 获取:
-
Object.keys(obj)→ 返回字符串键数组(不含 Symbol) -
Object.getOwnPropertyNames(obj)→ 同上 -
Object.getOwnPropertySymbols(obj)→ 只返回 Symbol 键数组 -
Reflect.ownKeys(obj)→ 同时返回字符串键 + Symbol 键
这使得 Symbol 成为一种轻量级的“非公开”属性机制(注意:不是真正私有,只是默认不可枚举)。
全局 Symbol 注册表:Symbol.for() 和 Symbol.keyFor()
普通 Symbol() 每次都新建,无法跨作用域共享。若需全局唯一且可复用的 Symbol,用 Symbol.for(key):
这本书并不是一本语言参考书,但它是一个Android开发者去学习Kotlin并且使用在自己项目中的一个工具。我会通过使用一些语言特性和有趣的工具和库来解决很多我们在日常生活当中都会遇到的典型问题。 这本书是非常具有实践性的,所以我建议你在电脑面前跟着我的例子和代码实践。无论何时你都可以在有一些想法的时候深入到实践中去。 这本书适合你吗? 写这本书是为了帮助那些有兴趣 使用Kotlin语言来进行开发的Android开发者。 如果你符合下面这些情况,那这本书是适合你的: 你有相关Android开发和Andro
const s1 = Symbol.for('debug');
const s2 = Symbol.for('debug');
console.log(s1 === s2); // true
Symbol.for() 会在全局注册表中查找,存在则复用,否则新建并登记。对应地,Symbol.keyFor(sym) 可反查该 Symbol 的注册键名(仅对 Symbol.for() 创建的生效)。
⚠️ 注意:不要滥用全局注册,容易因键名重复引发隐式耦合;只在真正需要跨模块协调时使用,例如自定义迭代器协议中统一用 Symbol.iterator。
常见陷阱与注意事项
Symbol 值不能被隐式转换为字符串,直接拼接会报错:
const sym = Symbol('test');
console.log('prefix' + sym); // TypeError: Cannot convert a Symbol value to a string
必须显式调用 sym.toString() 或 String(sym)。
另外,JSON 序列化会忽略 Symbol 键及其值:JSON.stringify({ [sym]: 123 }) → {};用 Symbol 定义的 getter/setter 在 Object.assign() 时也不会被复制。
Symbol 不是真正的私有机制(Object.getOwnPropertySymbols() 可见),也不提供访问控制;它本质是“命名隔离”+“枚举隔离”,适合元编程场景,比如实现 Symbol.iterator、Symbol.toPrimitive 等内置协议。









