17370845950

Symbol 是 JavaScript 中用于创建唯一不可变标识符的基本类型，核心用途是避免属性名冲突、实现软私有属性、支持全局共享（Symbol.for）及自定义对象行为（如 Symbol.iterator）。

Symbol 是 JavaScript 中的基本数据类型之一，主要用来创建**唯一且不可变的标识符**，最核心的用途是避免对象属性名冲突，尤其适合实现私有属性、内部方法或第三方库的扩展机制。

防止属性名冲突

当多个模块或库向同一个对象添加属性时，字符串键容易重名覆盖。Symbol 每次调用 Symbol() 都返回一个全新值，即使描述相同也互不相等：

• Symbol('id') !== Symbol('id')
• 可作为对象的属性键：obj[Symbol('version')] = '1.2.0'
• 该属性不会被 for...in、Object.keys() 或 JSON.stringify() 遍历到，天然“隐藏”

定义全局共享的 Symbol（Symbol.for）

如果需要跨文件或跨模块复用同一个 Symbol，可用 Symbol.for(key)：

• Symbol.for('debug') 在整个运行时中只生成一次，后续调用返回同一值
• 配合 Symbol.keyFor(sym) 可反查注册名
• 适合框架级约定，比如 React 用 Symbol.for('react.element') 标识虚拟 DOM 对象

内置 Symbol（Well-known Symbols）

JavaScript 预定义了一批以 Symbol. 开头的特殊 Symbol，用于自定义对象行为：

• Symbol.iterator：让对象支持 for...of 和展开运算符（如 [...obj]）
• Symbol.toStringTag：影响 Object.prototype.toString.call(obj) 的返回值（如 [object MyType]）
• Symbol.hasInstance：自定义 instanceof 的判断逻辑
• Symbol.toPrimitive：控制对象转原始值（如 +obj、`${obj}`）时的行为

模拟私有成员（非真正私有）

虽然 Symbol 属性不能被枚举，但并非完全私有——仍可通过 Object.getOwnPropertySymbols() 或 Reflect.ownKeys() 访问：

• 适合“软私有”，即不希望被随意遍历或误操作，但不防调试或高级反射
• 常与闭包结合使用，例如在类内部用 Symbol 存储实例状态，外部难以意外覆盖
• 比用下划线命名（如 _internalId）更可靠，语义更明确

基本上就这些。Symbol 不复杂，但容易忽略它在设计健壮接口和避免命名污染上的实际价值。