17370845950

Symbol 是 JS 中唯一能创建“真正私有属性”的原语，专治对象属性名冲突，通过唯一性、不可枚举性和协议化设计实现可控暴露与命名隔离。

Symbol 是 JS 中唯一能创建“真正私有属性”的原语

它不解决“数据封装”的通用需求，而是专治对象属性名冲突——尤其是第三方库、框架或跨模块协作时，你无法控制别人往 Object.prototype 或某个共享对象上加什么键。

比如两个库都定义了 cache 属性，又都用 obj.cache = {}，必然覆盖。用 Symbol('cache') 就能天然隔离，因为每次调用都返回新值，且不参与枚举、JSON.stringify、for...in 等常规遍历。

• Symbol() 每次返回的值严格不相等（Symbol() !== Symbol()），哪怕描述相同
• Symbol.for('key') 才是全局注册表：相同字符串返回同一个 Symbol，适合跨模块通信
• 对象属性名用 Symbol 时，必须用方括号访问：obj[mySym] = 'value'，点号无效

Symbol 作为对象内部状态的“隐藏句柄”

很多内置方法依赖 Symbol 做协议钩子，比如 Symbol.iterator 让对象可被 for...of 遍历，Symbol.toStringTag 控制 Object.prototype.toString.call(obj) 的输出。

这些不是约定俗成的字符串键，而是硬编码识别的 Symbol——你用字符串 'iterator' 完全没用，必须用 Symbol.iterator。

• 自定义迭代器必须挂在 [Symbol.iterator] 上，否则 for...of 不认
• Symbol.toPrimitive 决定对象在 +、== 等运算中转成什么原始值
• 这些 Symbol 是语言级契约，不可替代，也不可模拟

为什么不用 WeakMap 或闭包代替 Symbol？

WeakMap 能存私有数据，闭包也能封住变量，但它们解决的是“值私有”，而 Symbol 解决的是“键私有”。关键区别在于：Symbol 作为属性名，仍属于对象自身，可被 Object.getOwnPropertySymbols() 获取，也参与原型链查找；WeakMap 则完全脱离对象结构，靠引用绑定。

• 想让属性出现在 Object.keys(obj) 之外，但仍在 Object.getOwnPropertyNames(obj) 之外 → 用 Symbol
• 想彻底隐藏数据，连调试时都不希望被反射到 → 用 WeakMap 或闭包
• Symbol 属性会被 Object.assign({}, obj) 忽略，但 Reflect.ownKeys(obj) 能拿到它

const sym1 = Symbol('id');
const sym2 = Symbol('id');
const obj = { [sym1]: 123, name: 'test' };

console.log(sym1 === sym2); // false
console.log(Object.keys(obj)); // ['name']
console.log(Reflect.ownKeys(obj)); // ['name', Symbol(id)]
console.log(obj[sym1]); // 123
console.log(obj.sym1); // undefined —— 点号访问不了 Symbol 键

Symbol 的真实价值不在“私有”，而在“可控暴露”：它让你在开放对象结构的同时，避开命名污染，同时为语言机制提供稳定、不可伪造的协议入口。别把它当黑魔法，它是 JS 对象模型里最冷静的一把钥匙。