symbol是javaScript中唯一且不可变的原始类型,用于创建不冲突的对象属性键;其值唯一、不隐式转字符串、不可枚举,可通过Symbol.for()全局共享,常用于安全扩展对象行为。

Symbol 是 javascript 中一种原始数据类型,专门用来创建唯一、不可变的值,常用于对象属性键,避免命名冲突。
Symbol 的核心特点
每个 Symbol 值都是独一无二的,即使描述(description)相同,它们也不相等:
-
Symbol('foo') !== Symbol('foo')—— 两次调用返回的是两个不同的 Symbol - Symbol 不会被隐式转换为字符串(使用
String(sym)或sym.toString()才能转) - Symbol 属性不会出现在
for...in、Object.keys()、jsON.stringify()中,属于“隐藏”键(但可通过Object.getOwnPropertySymbols()获取)
如何创建 Symbol 键
用 Symbol() 函数创建,可选传入字符串描述(仅作调试用,不影响唯一性):
const id = Symbol('id');const name = Symbol('name');- 也可用全局注册表避免重复创建:
Symbol.for('sharedKey')—— 相同字符串返回同一个 Symbol;而Symbol.keyFor(sym)可反查注册名
用 Symbol 作为对象键的实际例子
比如给第三方对象安全添加私有属性,不干扰原有结构:
立即学习“Java免费学习笔记(深入)”;
const user = { name: 'Alice' };const userId = Symbol('userId');user[userId] = 123;console.log(user[userId]); // 123console.log(Object.keys(user)); // ['name'] —— userId 不会暴露
Symbol 在实际开发中的常见用途
它不只是“造唯一键”,更关键的是提供一种可控的、非侵入式的扩展机制:
- 定义对象内部状态(如迭代器的
Symbol.iterator) - 库作者添加自有方法而不污染用户对象的公共接口
- 替代字符串常量作为 action type(如 Redux 中用 Symbol 防止字符串拼写错误)
- 配合
WeakMap实现真正的私有字段(es6+ 类中可用#私有字段,但 Symbol + WeakMap 是更早的模式)
基本上就这些。Symbol 不复杂,但容易忽略它的“不可枚举”和“全局隔离”特性——正是这两点让它成为安全扩展对象行为的可靠工具。