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）是改变语言行为的“钩子”
它们不是用来存数据的，而是让对象响应特定语言操作。比如实现自定义迭代：
立即学习“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 本质不同，不该被自动桥接。
