17370845950

Symbol 是 JavaScript 中唯一能保证值唯一性的原始类型，每次调用 Symbol() 都返回全新不相等的值，其唯一性由引擎内部私有标识保障，不可枚举且防冲突，但 JSON.stringify 会忽略、不可点访问、类中不能 static 声明。

Symbol 是 JavaScript 中唯一能保证值唯一性的原始类型，专门用来生成不可被枚举、不可被意外覆盖的对象键。

Symbol 为什么能创建真正唯一的对象键？

每次调用 Symbol() 都返回一个全新且不相等的值，即使描述相同：

const a = Symbol('foo');
const b = Symbol('foo');
console.log(a === b); // false

这种唯一性不是靠字符串内容，而是引擎内部维护的私有标识。它不像 Symbol.for('foo') 那样会全局复用，所以普通 Symbol() 天然适合做“防冲突”的私有属性名。

如何用 Symbol 作为对象键而不被遍历到？

Symbol 键不会出现在 for...in、Object.keys()、Object.getOwnPropertyNames() 中，但可通过 Object.getOwnPropertySymbols() 显式获取：

const sym = Symbol('id');
const obj = { [sym]: 123, name: 'alice' };

console.log(Object.keys(obj));                  // ['name']
console.log(Object.getOwnPropertyNames(obj));   // ['name']
console.log(Object.getOwnPropertySymbols(obj)); // [Symbol(id)]

这意味着你可以在不污染对象公共接口的前提下，挂载元数据或内部状态。

Symbol 作为私有字段的实际使用场景和坑

常见用途包括：缓存计算结果、标记对象类型、避免第三方库属性名冲突；但要注意几个关键限制：

• JSON.stringify() 会直接忽略 Symbol 键，序列化后丢失
• 不能用点号访问：obj.sym 不行，必须用方括号 obj[sym]
• 类中无法用 static [sym] = ... 定义静态 Symbol 属性（需在类外赋值）
• WeakMap 键必须是对象，不能用 Symbol；但 Map 支持 Symbol 作键

如果你需要跨模块共享某个 Symbol，必须用 Symbol.for(key) 注册到全局符号注册表，否则不同模块调用 Symbol('x') 得到的仍是不同值。

Symbol 的设计初衷不是替代私有字段（如 #field），而是提供一种可控的、可反射的“隐藏但非完全私有”的键机制——它的“唯一性”和“不可枚举性”是硬保障，但“是否可见”取决于你用什么 API 去查。这点容易被低估。