17370845950

Symbol 是 JavaScript 中用于创建唯一、不可变属性键的原始类型，具有唯一性（Symbol('a')≠Symbol('a')）、不可变性、可转字符串但不参与常规遍历等特性，适用于避免命名冲突和语义化标识内部属性。

Symbol 是 JavaScript 中一种原始数据类型，专门用来创建唯一、不可变的值，常用于定义对象中不会被意外覆盖的属性键。

Symbol 的基本特性

每个 Symbol 值都是独一无二的，即使描述文字相同，它们也不相等。这和字符串完全不同——两个相同内容的字符串是相等的，但两个同名 Symbol 永远不相等。

• 唯一性：Symbol('foo') !== Symbol('foo')
• 不可变性：Symbol 值一旦创建就不能修改
• 非字符串但可转为字符串：不能隐式转为数字，但可用 String(sym) 或 sym.toString() 转为字符串（如 "Symbol(foo)"）
• 不会出现在 for...in、Object.keys() 或 JSON.stringify() 中：它属于“私有”键（严格来说是“非枚举的自有属性”，但不是真正私有）

如何用 Symbol 创建唯一属性键

把 Symbol 当作对象属性名使用，就能避免命名冲突。尤其适合库作者或多人协作时防止属性被覆盖。

• 直接赋值：const myKey = Symbol('id'); obj[myKey] = 123;
• 用计算属性语法定义：const obj = { [myKey]: 'private data' };
• 用 Object.defineProperty 显式添加：Object.defineProperty(obj, myKey, { value: 'hidden', enumerable: false })

这样设置后，myKey 对应的属性不会被 for...in 遍历到，也不会被 Object.keys(obj) 返回，但可通过 Object.getOwnPropertySymbols(obj) 获取。

全局 Symbol 注册表：Symbol.for() 和 Symbol.keyFor()

如果需要跨模块复用同一个 Symbol（即“全局唯一，而非每次新建都唯一”），可用 Symbol.for(key)。

• Symbol.for('debug') 第一次调用会创建并注册，之后再调用返回同一个 Symbol
• Symbol.keyFor(sym) 可查出该 Symbol 是否在全局注册表中，以及它的键名（仅对 Symbol.for() 创建的生效）
• 注意：Symbol('debug') !== Symbol.for('debug') —— 前者每次新建都不同，后者全局共享

实际使用小提醒

Symbol 不是“真正的私有”，只是不被常规遍历方法发现；想彻底隐藏数据，仍需闭包或 # 私有字段（ES2025+）。Symbol 更适合语义化地表达“这个键不该被外部随意操作”，比如内置方法使用的 Symbol.iterator、Symbol.toStringTag 等。

基本上就这些。用好 Symbol，能让对象结构更清晰，也减少键名冲突的风险。