Symbol 是唯一不可变原始值,每次调用 Symbol() 都生成新值,靠内部标识而非字符串内容判等;Symbol.for() 通过全局注册表实现跨模块共享,而 Symbol() 完全隔离。

Symbol 是 JavaScript 中唯一、不可变的原始值,每次调用 Symbol() 都生成一个全新且不相等的值,适合用作对象属性键来避免命名冲突。
Symbol 为什么能保证唯一?
它不是靠字符串内容判断相等,而是靠内存地址(内部标识);即使传入相同描述符,Symbol('a') 和 Symbol('a') 也不相等。
常见错误现象:
误以为 Symbol('id') 全局唯一 → 实际每次调用都新建一个,无法跨模块共享。
-
Symbol('foo') === Symbol('foo')返回false - 只有
Symbol.for('foo') === Symbol.for('foo')才为true(使用全局注册表) -
typeof Symbol()返回"symbol",不是对象
Symbol.for() 和 Symbol() 的关键区别
前者查全局注册表:存在就复用,不存在才新建;后者永远新建,完全隔离。
立即学习“Java免费学习笔记(深入)”;
使用场景:
— Symbol():私有属性、临时键(如遍历器接口 Symbol.iterator)
— Symbol.for():需要跨文件/跨库共享的逻辑标识(如自定义类型检查)
const s1 = Symbol.for('debug');
const s2 = Symbol.for('debug');
console.log(s1 === s2); // true
const s3 = Symbol('debug');
const s4 = Symbol('debug');
console.log(s3 === s4); // false
Symbol 作为对象属性键的注意事项
它不会被 for...in、Object.keys()、JSON.stringify() 捕获,但可通过 Object.getOwnPropertySymbols() 或 Reflect.ownKeys() 获取。
- 对象字面量中必须用方括号:
{ [Symbol('x')]: 'value' },不能写{ Symbol('x'): 'value' } - 用
Object.assign({}, obj)会忽略 Symbol 键,需手动合并 - ES2015+ 中,
Map和Set可直接用 Symbol 作键,无兼容性问题
容易被忽略的细节
Symbol 值不能隐式转为字符串 —— 直接拼接会报错 TypeError: Cannot convert a Symbol value to a string。
必须显式调用 .toString() 或 String(sym),但更推荐只用于调试,生产环境避免暴露描述符。
const sym = Symbol('my-key');
console.log(`key: ${sym}`); // ❌ 报错
console.log(`key: ${sym.toString()}`); // ✅ 输出 "key: Symbol(my-key)"
真正难处理的是调试时看不到 Symbol 属性 —— 浏览器开发者工具里它们默认折叠,得手动展开 [[Description]] 或用 Object.getOwnPropertySymbols(obj) 查看。











