Symbol是JavaScript中唯一且不可枚举的键类型,用于防冲突和隐匿属性;Symbol()每次返回新值,Symbol.for()实现全局共享;Symbol属性不参与for...in、Object.keys()或JSON.stringify()。

Symbol 是 JavaScript 中唯一且不可枚举的键类型
Symbol 的核心作用不是“替代字符串”,而是提供一种**防冲突、不被意外遍历到**的对象属性标识方式。它不用于通用命名,而用于实现内部逻辑隔离——比如内置方法(Symbol.iterator)、库作者避免覆盖用户属性、或框架私有字段。
用 Symbol() 创建唯一值,但注意不能用 new
Symbol() 每次调用都返回一个全新值,哪怕描述相同;而 new Symbol() 会直接报错 TypeError: Symbol is not a constructor。描述字符串仅用于调试显示,不影响相等性判断。
const a = Symbol('key');
const b = Symbol('key');
console.log(a === b); // false
console.log(a.description); // "key"
全局 Symbol 注册表:Symbol.for() 和 Symbol.keyFor()
当需要跨模块共享同一个 Symbol(比如统一定义一个插件钩子名),就得用全局注册表。它基于字符串键做单例管理,和直接调用 Symbol() 完全不同。
-
Symbol.for('debug'):查找已注册的,没有则新建并登记 -
Symbol.keyFor(sym):只对Symbol.for()创建的 Symbol 有效,返回注册名;对Symbol()返回undefined - 注意:全局注册表是全局环境共享的,第三方库滥用会导致命名冲突
Symbol 属性不会出现在 for...in、Object.keys() 或 JSON.stringify() 中
这是 Symbol 最关键的行为特征——它天然“隐身”。想获取对象上所有 Symbol 键,必须显式调用 Object.getOwnPropertySymbols();想获取全部(含 Symbol + 字符串),得合并 Object.keys() 和 Object.getOwnPropertySymbols()。
立即学习“Java免费学习笔记(深入)”;
const obj = {
name: 'alice',
[Symbol('id')]: 123
};
console.log(Object.keys(obj)); // ['name']
console.log(Object.getOwnPropertySymbols(obj)); // [Symbol(id)]
这种隐匿性让 Symbol 成为实现“弱公开接口”的理想工具,但也意味着调试时容易遗漏——尤其当某个行为依赖于 Symbol 属性却没文档说明时。











