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免费学习笔记（深入）”；
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
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)); // undefined
Symbol 作为对象属性键：隐藏但可枚举？
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() —— 但得小心全局污染风险。
