Symbol 是 JavaScript 的第七种原始类型,每次调用 Symbol() 都返回全新且不相等的值,天生不可枚举、不可遍历,适合做私有属性键或防冲突标识符。

Symbol 是什么,为什么它能当唯一标识
Symbol 是 JavaScript 原生的第七种原始类型,每次调用 Symbol() 都会返回一个**全新且不相等**的值,哪怕描述相同。它天生不可枚举、不可遍历、不会被 for...in 或 JSON.stringify 捕获,适合做私有属性键或防冲突的标识符。
用 Symbol() 创建基础唯一标识
最常用方式:直接调用构造函数(注意不能用 new,否则报 TypeError: Symbol is not a constructor)。
const id1 = Symbol('user');
const id2 = Symbol('user');
console.log(id1 === id2); // false
console.log(typeof id1); // "symbol"
- 参数
'user'是可选描述(description),仅用于调试输出,不影响值的唯一性 - 即使两个 Symbol 描述完全一样,它们也永远不相等
- Symbol 值不能隐式转为字符串,
console.log(id1 + '')会报错;必须显式调用id1.toString()或用模板字符串`${id1}`
用 Symbol.for() 创建全局登记的 Symbol
当你需要跨模块/跨文件复用同一个 Symbol(比如统一的事件名或配置键),就该用 Symbol.for(key)。它会先在全局 Symbol 注册表中查找,存在则返回,否则新建并登记。
const s1 = Symbol.for('debug');
const s2 = Symbol.for('debug');
console.log(s1 === s2); // true
const s3 = Symbol('debug'); // 注意:没用 .for()
console.log(s1 === s3); // false —— 普通 Symbol 和全局 Symbol 永远不同
- 键名
'debug'是字符串,会被强制转为字符串(比如Symbol.for(42)等价于Symbol.for('42')) - 可通过
Symbol.keyFor(s1)反查登记时用的键名,但对普通Symbol()返回undefined - 全局注册表是共享的,命名需谨慎,避免第三方库冲突(建议加前缀,如
'myapp:timeout')
Symbol 作为对象属性键的注意事项
Symbol 作 key 能实现“隐藏但可访问”的属性,但它不会出现在常规遍历中。
立即学习“Java免费学习笔记(深入)”;
const obj = {};
const uid = Symbol('id');
obj[uid] = 123;
console.log(obj[uid]); // 123
console.log(Object.keys(obj)); // []
console.log(Object.getOwnPropertyNames(obj)); // []
console.log(Object.getOwnPropertySymbols(obj)); // [Symbol(id)]
- 必须用
Object.getOwnPropertySymbols()才能获取 Symbol 键,Reflect.ownKeys()也能拿到(它返回所有键,含 Symbol) - 用
in操作符或hasOwnProperty()判断 Symbol 属性时,结果为false—— 它们只检查字符串键 - 类的
private field (#id)更严格(完全无法外部访问),Symbol 是“软私有”,适合插件扩展、元数据标记等场景
getOwnPropertySymbols;真正要封死访问,得用闭包或私有字段。











