Symbol 是 JavaScript 的第七种原始类型，每次调用 Symbol() 都返回独一无二、不可重复创建的值，核心用途是作为安全防冲突的对象属性键或内置方法钩子。
Symbol 是什么：JavaScript 中的原始类型唯一值
Symbol 是 JavaScript 的第七种原始类型（其余为 string、number、boolean、null、undefined、bigint），它每次调用 Symbol() 都会返回一个 ** 独一无二、不可被重复创建 ** 的值。它不是对象，不能用 new 调用，也不支持属性赋值（比如 sym.foo = 1 会静默失败）。
它的核心用途不是“标识字符串”，而是作为 ** 安全的、防冲突的键名 **，尤其用于对象属性或内置方法的定制钩子（如 Symbol.iterator）。
如何创建 Symbol：带描述 vs 不带描述，全局注册 vs 局部唯一
Symbol 创建有三种常见方式，关键 区别 在于「是否可复用」和「是否跨执行上下文共享」：
-
Symbol('desc')：每次调用都生成新值，即使描述相同 —— 最常用，用于私有 / 局部唯一键 -
Symbol.for('key')：在全局 Symbol 注册表 中查找或创建；同一字符串多次调用返回同一个 Symbol —— 用于跨模块 / 跨 iframe 共享标识符 -
Symbol.keyFor(sym)：仅对Symbol.for()创建的 Symbol 有效，返回其注册时用的字符串键；对普通Symbol()返回undefined
示例对比：
立即学习“Java 免费学习笔记（深入）”；
const a = Symbol('id'); const b = Symbol('id'); console.log(a === b); // false —— 描述相同，值不同 const x = Symbol.for('shared'); const y = Symbol.for('shared'); console.log(x === y); // true —— 全局注册，值相同 console.log(Symbol.keyFor(x)); // 'shared' console.log(Symbol.keyFor(a)); // undefinedSymbol 作为对象属性键：隐藏但可枚举？
Symbol 可以作为对象属性名使用，且天然避免命名冲突。但它不会出现在 for……in、Object.keys() 或 JSON.stringify() 中，属于「非字符串键」的特殊存在：
-
Object.getOwnPropertyNames(obj)：只返回字符串键，不包含 Symbol 键 -
Object.getOwnPropertySymbols(obj)：专门获取所有 Symbol 类型的自有属性键 -
Reflect.ownKeys(obj)：同时返回字符串键 + Symbol 键（ES2015+ 推荐用法）
示例：
const sym1 = Symbol('hidden'); const sym2 = Symbol('meta'); const obj = {name: 'Alice', [sym1]: 42, [sym2]: {version: 1} }; console.log(Object.keys(obj)); // ['name'] console.log(Object.getOwnPropertySymbols(obj)); // [Symbol(hidden), Symbol(meta)] console.log(Reflect.ownKeys(obj)); // ['name', Symbol(hidden), Symbol(meta)]容易踩的坑：类型转换、相等判断与 JSON 序列化
Symbol 无法隐式转为字符串或数字，任何强制转换都会报错：
-
String(sym)✅ 可行（返回"Symbol(desc)"） -
sym + ''❌ 报TypeError: Cannot convert a Symbol value to a string -
Number(sym)❌ 同样报错 -
JSON.stringify({key: Symbol('x') })→{}（Symbol 键被完全忽略） - 两个 Symbol 永远不相等，除非是同一个引用（
===判断）或同属Symbol.for()注册表
真正需要“唯一标识符”的场景（比如缓存 key、私有状态容器），别用字符串拼接或时间戳，直接用 Symbol()；若需跨环境一致，才考虑 Symbol.for() —— 但得小心全局污染风险。
