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项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
立即学习“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 的“唯一”只解决命名冲突，“不可变”只约束值本身，它不提供封装或安全性。拿它当私有字段用，本质上是靠约定而非机制。
