17370845950

Symbol 是 JavaScript 中 ES6 引入的第七种原始类型，用于生成唯一且不可变的标识符；每次调用 Symbol() 都返回新值，即使描述相同也不相等，其描述仅作调试用，不参与比较或逻辑判断。

Symbol 是什么：JavaScript 中的原始类型之一

Symbol 是 ES6 引入的第七种原始类型（其他六种是 string、number、boolean、null、undefined、bigint），它不表示某个具体的数据值，而是用来生成**唯一标识符**。每次调用 Symbol() 都会返回一个全新的、与其他所有 Symbol 值都不相等的值，哪怕描述相同。

为什么 Symbol 值是唯一且不可变的

唯一性不是靠“内容比较”实现的，而是由 JavaScript 引擎在创建时保证的内部机制：每个 Symbol 实例都有一个隐藏的、不可访问的内部值（类似 UUID），即使两个 Symbol 用相同参数创建（如 Symbol('foo') 调用两次），它们的内部值也不同，因此 === 和 == 都返回 false。

不可变性体现在：Symbol 值本身不能被修改（没有属性可赋值，也不能被 Object.defineProperty 添加可写属性），其描述字符串（description）仅用于调试显示，不参与相等性判断，也无法通过任何方式更改。

• Symbol 不是对象，所以不能添加属性：

  const s = Symbol('test');
  s.foo = 123;
  console.log(s.foo); // undefined

• Symbol 描述只是标签，不影响唯一性：

  const a = Symbol('key');
  const b = Symbol('key');
  console.log(a === b); // false

• 全局注册表 Symbol.for() 是例外：它按字符串键查表复用，但仍是 Symbol 类型，且与直接调用 Symbol() 创建的值永远不等：

  const x = Symbol.for('shared');
  const y = Symbol.for('shared');
  const z = Symbol('shared');
  console.log(x === y); // true
  console.log(x === z); // false

Symbol 的典型用途和易错点

Symbol 最常用于避免属性名冲突（如库作者向对象注入私有字段），或定义语言内部行为的钩子（如 Symbol.iterator）。但它不是“私有”的银弹——所有 Symbol 属性仍可通过 Object.getOwnPropertySymbols() 或 Reflect.ownKeys() 暴露，只是不会出现在 for...in 或 JSON.stringify() 中。

立即学习“Java免费学习笔记（深入）”；

• 用作对象属性键时，必须用方括号：

  const sym = Symbol('id');
  const obj = {};
  obj[sym] = 42; // ✅ 正确
  obj.sym = 42;  // ❌ 这只是普通字符串 key 'sym'

• 不能隐式转换为字符串：

  const s = Symbol('msg');
  console.log('hello ' + s); // TypeError: Cannot convert a Symbol value to a string

• 显式转字符串需调用 s.toString() 或 String(s)，但不要依赖描述内容做逻辑分支——它只是调试用的。

Symbol 与其它唯一性方案对比（WeakMap / private fields）

Symbol 常被拿来和 WeakMap 或类的 #private 字段比较，但三者目的不同：

• Symbol 提供的是「命名空间隔离」，不是访问控制；任何人都能读写该属性，只要他们拿到 Symbol 实例。
• WeakMap 提供真正的外部不可见性：键必须是对象，值只能通过该对象访问，且不阻止垃圾回收。
• #private 字段是语法级封装，连同名 Symbol 也无法从外部访问（报 SyntaxError 或 ReferenceError）。

也就是说，Symbol 的“唯一”只解决命名冲突，“不可变”只约束值本身，它不提供封装或安全性。拿它当私有字段用，本质上是靠约定而非机制。