17370845950

Symbol 是 JavaScript 第七种原始类型，ES6 引入，核心特性为独一无二且不可覆盖；用 Symbol() 生成，描述仅用于调试；不能隐式转字符串；作为对象属性名可避免冲突，不被 Object.keys 等枚举；支持内置知名符号定制行为；适合替代魔术字符串作安全常量。

Symbol 是 JavaScript 中第七种原始数据类型，ES6 引入，核心就两点：**独一无二、不可被覆盖**。

它不是字符串，但长得像

Symbol 值由 Symbol() 函数生成，不能用 new 调用：

• const s1 = Symbol('id') 和 const s2 = Symbol('id') 不相等 —— 即使描述一样，也各自独立
• 描述（description）只用于调试显示，比如 console.log(s1) 输出 Symbol(id)，不影响值本身
• 不能隐式转成字符串：'' + Symbol('a') 会报错；必须显式调用 .toString() 或 String(sym)

它最实用的特性是“不冲突”

作为对象属性名时，Symbol 键天然隔离，不会和字符串键打架：

• const userId = Symbol('userId');
user[userId] = 'U123';
user.userId = 'oops'; —— 这两行互不影响
• Object.keys(user)、for...in、JSON.stringify() 都看不到 Symbol 键，相当于“隐形但可访问”
• 想查它？得用 Object.getOwnPropertySymbols(user)

它能干很多“底层活”

JavaScript 内置了一批以 Symbol.xxx 开头的知名符号（well-known symbols），用来定制对象行为：

• Symbol.iterator：让对象支持 for...of 循环
• Symbol.toStringTag：改写 Object.prototype.toString.call(obj) 的输出
• Symbol.toPrimitive：控制 +obj 或 obj == 123 这类转换逻辑
• Symbol.hasInstance：自定义 obj instanceof MyClass 的判断方式

它还能当安全常量用

替代“魔术字符串”，避免拼写错误或意外相等：

• const STATUS_OK = Symbol('ok');
const STATUS_ERR = Symbol('error');
• 在 switch 或状态判断中用它们，语义清晰、值绝对唯一、不怕同名字符串干扰
• 比字符串更可靠，又比私有字段（#field）兼容性更好

基本上就这些。Symbol 不复杂，但容易忽略——它不是为“完全隐藏”设计的，而是为“不撞车、不误判、可定制”服务的。