JavaScript Symbol是什么_它如何创建唯一标识符

Symbol 是 JS 中唯一且不可变的原始值，每次调用 Symbol() 都返回独一无二的值，用于解决属性名冲突和私有标识问题；它不可枚举、不被 JSON 序列化，仅能通过 Object.getOwnPropertySymbols() 访问。

Symbol 是什么：JS 中唯一且不可变的原始值

Symbol 是 JavaScript 的第七种原始类型（其余为 string、number、boolean、null、undefined、bigint），它的核心价值在于「每次调用 Symbol() 都返回一个独一无二的值」——哪怕描述相同，两个 Symbol 也绝不相等。

它不是用来替代字符串或数字的，而是解决「属性名冲突」和「私有/内部标识」这类问题的底层机制。比如你无法通过 for...in 或 Object.keys() 枚举到 Symbol 键，这使它天然适合做“隐藏但可访问”的属性名。

如何创建 Symbol：带描述 vs 不带描述的区别

Symbol 必须用函数调用方式创建，不能加 new，否则报 TypeError: Symbol is not a constructor。描述（description）参数是可选字符串，仅用于调试显示，不影响唯一性。

• Symbol('foo') 和 Symbol('foo') 是两个完全不同的值，=== 返回 false
• 空描述 Symbol() 和 Symbol('') 也不相等
• 描述会被转为字符串，Symbol(42) 等价于 Symbol('42')

const s1 = Symbol('id');
const s2 = Symbol('id');
console.log(s1 === s2); // false
console.log(s1.toString()); // "Symbol(id)"
console.log(Symbol(123).toString()); // "Symbol(123)"

Symbol.for() 和 Symbol.keyFor()：全局注册表的例外

普通 Symbol() 总是唯一的，但 Symbol.for(key) 会先检查全局 Symbol 注册表中是否已有该 key 对应的 Symbol；有则返回，无则新建并登记。这意味着它打破了“每次必唯一”的规则，但提供了跨模块共享 Symbol 的能力。

天工大模型

中国首个对标ChatGPT的双千亿级大语言模型

下载

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

• Symbol.for('debug') 多次调用返回同一个 Symbol
• Symbol.keyFor(sym) 只对通过 Symbol.for() 创建的 Symbol 有效，对普通 Symbol 返回 undefined
• 全局注册表是全局环境共享的，Node.js 模块间、iframe 间都可见

const a = Symbol.for('shared');
const b = Symbol.for('shared');
console.log(a === b); // true

const c = Symbol('shared');
console.log(Symbol.keyFor(c)); // undefined
console.log(Symbol.keyFor(a)); // "shared"

Symbol 作为对象属性键：枚举性与访问限制

Symbol 可以作为对象属性键使用，但它的行为和字符串键完全不同：它不会出现在 Object.keys()、Object.getOwnPropertyNames() 或 JSON.stringify() 中，只能通过 Object.getOwnPropertySymbols() 或 Reflect.ownKeys() 获取。

• 用 obj[sym] = value 赋值后，必须用同个 Symbol 实例才能读取
• Symbol 键属性默认是“不可枚举”的，但它是可配置、可写的（除非显式 Object.defineProperty 修改）
• ES6 内置大量知名 Symbol（如 Symbol.iterator、Symbol.toStringTag），用于定制对象行为

const sym = Symbol('hidden');
const obj = { [sym]: 'secret', name: 'alice' };

console.log(Object.keys(obj)); // ['name']
console.log(Object.getOwnPropertySymbols(obj)); // [Symbol(hidden)]
console.log(obj[sym]); // 'secret'
console.log(JSON.stringify(obj)); // {"name":"alice"}