Symbol 是 JavaScript 中唯一不可变的原始值,用作全局唯一的属性键以避免冲突;每次 Symbol() 调用返回新值,需用方括号访问,遍历时被忽略但可通过 Object.getOwnPropertySymbols 获取;Symbol.for() 实现跨上下文共享,内置 Symbol 如 Symbol.iterator 用于定制语言行为。

Symbol 是 JavaScript 中唯一不可变的原始值,核心用途是避免属性名冲突
它不是“私有变量”,也不是“访问控制机制”,而是一个全局唯一的键(key)生成器。每次调用 Symbol() 都返回一个新值,哪怕描述字符串一样:Symbol('id') === Symbol('id') 永远是 false。这直接解决了对象属性被意外覆盖的问题——比如你给第三方 user 对象加个 ID 字段,用字符串 'id' 可能撞上别人已有的字段,但用 Symbol('id') 就绝对安全。
怎么用 Symbol 作为对象属性名?必须用方括号,不能用点号
因为点号语法只接受字符串字面量,obj.symbolKey 实际等价于 obj['symbolKey'],根本找不到 Symbol 键。正确写法只有中括号:
const id = Symbol('user-id');
const user = { name: 'Alice' };
user[id] = 1001; // ✅ 正确
console.log(user[id]); // 1001
console.log(user.id); // undefined ❌
console.log(user['id']); // undefined ❌
- 遍历时不会出现:它不会被
for...in、Object.keys()、JSON.stringify()捕获 - 但不是“完全隐藏”:可用
Object.getOwnPropertySymbols(user)或Reflect.ownKeys(user)拿到 - 深拷贝会保留它:
Object.assign({}, user)和结构赋值都会复制 Symbol 属性
全局 Symbol(Symbol.for())和普通 Symbol 的关键区别
普通 Symbol() 每次都全新,Symbol.for('cache') 则查全局注册表:存在就复用,不存在才新建。这意味着跨模块/跨文件共享同一个 Symbol 成为可能,但也带来风险:
const a = Symbol.for('debug');
const b = Symbol.for('debug');
console.log(a === b); // true ✅
-
Symbol.keyFor(sym)只对Symbol.for()创建的 Symbol 有效,对普通 Symbol 返回undefined - 滥用
Symbol.for()容易引发命名冲突(比如两个库都注册了Symbol.for('state')) - 除非明确需要跨上下文通信(如插件系统、调试工具),否则优先用普通
Symbol()
内置 Symbol(如 Symbol.iterator)是改变语言行为的“钩子”
它们不是用来存数据的,而是让对象响应特定语言操作。比如实现自定义迭代:
1、什么是店中店?店中店是全诚商多用户版的一大特色,它既是独立的个体,又具有群集功能。我们做个例子说明:假设尊贵的您现实生活中租赁了一个店面,店面空间很大,您可以把您的店面分割成很多独立空间再向别人转租,这样您可以额外获得一部分租赁费用收入,借以减少你的个人租赁费用投入,还能起到活跃销售场所的气氛,俗话说:货卖一堆吗。你租赁的店面可以完全分割成很多空间向外转租,也可以自己保留一块空间为自己销售商品
立即学习“Java免费学习笔记(深入)”;
const countdown = {
from: 3,
[Symbol.iterator]() {
return {
current: this.from,
next() {
return this.current > 0 ? { value: this.current--, done: false } : { done: true };
}
};
}
};
for (const n of countdown) console.log(n); // 3, 2, 1
-
Symbol.iterator→ 支持for...of和展开运算符 -
Symbol.toPrimitive→ 控制+ obj、obj + ''等类型转换结果 -
Symbol.toStringTag→ 修改Object.prototype.toString.call(obj)输出 - 这些 Symbol 必须定义在对象自身(非原型链),且值必须是函数或对象
真正容易被忽略的是:Symbol 本身不能隐式转字符串,console.log(sym) 会报错;要调试必须显式调用 sym.toString() 或读取 sym.description。这不是设计缺陷,而是语言刻意阻止混淆——字符串和 Symbol 本质不同,不该被自动桥接。










