17370845950

Symbol 是 JavaScript 的第七种原始类型，ES6 引入，本质是唯一、不可变、不可枚举的标识符，核心价值是作为不冲突、不暴露、不干扰的对象属性名，用于避免命名冲突、模拟弱私有属性、定义语义化常量键及通过内置 Symbol 定制对象底层行为。

Symbol 是 JavaScript 的第七种原始类型，ES6 引入，本质是**唯一、不可变、不可枚举的标识符**。它不是字符串，也不能被自动转换为字符串或数字，但可以安全地用作对象属性名——这是它最核心的价值：不冲突、不暴露、不干扰。

避免属性名覆盖和命名冲突

当你向已有对象（比如第三方库返回的对象）添加字段时，用字符串当 key 很容易撞车。Symbol 从根本上杜绝这个问题：

• 每次调用 Symbol() 都生成一个全新值，哪怕描述相同，Symbol('id') === Symbol('id') 也是 false
• 该属性不会出现在 for...in、Object.keys()、JSON.stringify() 中
• 外部代码没持有这个 Symbol 引用，就无法通过常规方式访问或覆盖它

模拟弱私有属性

虽然现在有 #field 私有字段语法，但 Symbol 在兼容旧环境或需要更灵活控制时仍很实用：

• 把 Symbol 定义在模块顶层，类内部用它存敏感数据（如 _balance）
• 外部无法用点号或方括号直接读写，除非你主动暴露 Symbol 或把它传出去
• 比下划线约定更可靠，属于“弱私有”——不是绝对安全，但比命名约定强得多

定义语义化且防误判的常量键

代替字符串定义状态码、动作类型、日志级别等，避免拼错、重复或意外相等：

• const LOADING = Symbol('loading') 和 const LOADING = 'loading' 看似一样，但后者可能被其他模块误赋值或覆盖
• 用 Symbol 做 switch 或 if 判断时，类型安全、无歧义
• 调试时能看到描述，比如 LOADING.toString() 返回 "Symbol(loading)"

通过内置 Symbol 定制对象底层行为

JavaScript 提供了一批以 Symbol.xxx 形式存在的“知名 Symbol”，它们是元编程的关键接口：

• Symbol.iterator：让对象支持 for...of
• Symbol.toStringTag：改变 Object.prototype.toString.call(obj) 的输出
• Symbol.toPrimitive：控制对象转数字/字符串时的行为（如 +obj 或 '' + obj）
• Symbol.asyncIterator：支持 for await...of
• Symbol.hasInstance：自定义 instanceof 判定逻辑

它不复杂，但容易忽略——尤其在封装工具、设计 API 或做兼容性方案时，Symbol 是那种“用了才知道真香”的小而关键的特性。