Symbol是JavaScript中唯一绝对不冲突的原始类型，用作私有属性键可避免覆盖和遍历暴露；Symbol()每次生成唯一值，Symbol.for()实现跨模块共享，内置Symbol如Symbol.iterator可定制语言行为。

Symbol 是 JavaScript 中唯一能保证“绝对不冲突”的原始类型，不是用来存数据的，而是用来当“钥匙”——开特定的门，且这把钥匙别人造不出来。

为什么不能用字符串当属性名？

当你往一个对象上加扩展字段（比如插件、日志标记、内部状态），用字符串键很容易被覆盖或误读：

• obj.id 和 obj['id'] 看似安全，但第三方库也可能写 obj.id = ...，直接覆盖
• for...in、Object.keys()、JSON.stringify() 全都能看到它，隐私性为零
• “魔术字符串”如 'cache_key' 散落在代码各处，改起来容易漏、难搜索

而 Symbol() 每次调用都返回一个全新值，哪怕描述一样：

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

怎么用 Symbol 做真正隔离的属性？

把它当计算属性名用，就能躲过常规遍历和序列化：

• 必须用方括号访问：obj[mySym]，不能用点号 obj.mySym
• Object.keys(obj)、for...in、JSON.stringify() 都看不到它
• 想查它？得用专门方法：Object.getOwnPropertySymbols(obj)
• 注意：它不是私有（Reflect.ownKeys() 和 getOwnPropertySymbols() 都能拿到），只是“不显眼”

const _internal = Symbol('internal');
const user = { name: 'Alice' };
user[_internal] = { lastLogin: Date.now() };
console.log(user[_internal]); // { lastLogin: 1736726... }
console.log(Object.keys(user)); // ['name']
console.log(Object.getOwnPropertySymbols(user)); // [Symbol(internal)]

什么时候需要全局唯一的 Symbol？用 Symbol.for()

单个模块里用 Symbol() 没问题，但跨文件/跨包想共享同一个 Symbol 键，就得走全局注册表：

• Symbol.for('logger') 第一次调用会创建并登记；之后再调用同名，返回同一个值
• Symbol.keyFor(sym) 只对 Symbol.for() 创建的 Symbol 有效，普通 Symbol() 返回 undefined
• 全局 Symbol 本质是字符串到 Symbol 的映射，所以 key 会被强制转成字符串

const s1 = Symbol.for('debug');
const s2 = Symbol.for('debug');
console.log(s1 === s2); // true
console.log(Symbol.keyFor(s1)); // 'debug'
console.log(Symbol.keyFor(Symbol('debug'))); // undefined

内置 Symbol 是怎么改变语言行为的？

JavaScript 用一些固定名称的 Symbol（如 Symbol.iterator）作为协议入口，你实现它，就能接管原生语法的行为：

• Symbol.iterator → 让对象支持 for...of 和展开运算符 [...obj]
• Symbol.toStringTag → 改变 Object.prototype.toString.call(obj) 的输出标签
• Symbol.hasInstance → 自定义 instanceof 判断逻辑
• 这些 Symbol 不是你“随便起名”的，必须用标准名，否则引擎不识别

const myArrayLike = {
  0: 'a', 1: 'b', length: 2,
  [Symbol.iterator]: function* () {
    for (let i = 0; i < this.length; i++) yield this[i];
  }
};
console.log([...myArrayLike]); // ['a', 'b']

最容易被忽略的一点：Symbol 值不能隐式转换成字符串——'' + sym 会报错，必须显式调用 sym.toString() 或 String(sym)。这点在调试和日志中常踩坑。