Symbol是ES6新增的唯一原始类型，每次调用返回独一无二值，不可复用、不参与隐式转换；用作对象属性键可防命名冲突，且默认不可枚举；Symbol.for()提供全局注册表，Symbol描述仅用于调试。

Symbol 是 JavaScript 中的唯一原始值

Symbol 是 ES6 新增的第七种原始类型，每次调用 Symbol() 都会返回一个**独一无二、不可被复用**的值。它既不是字符串，也不能被隐式转换成字符串（除非显式调用 .toString()），更不会参与 == 或 === 的自动类型转换（两个 Symbol 永远不相等，哪怕描述相同）。

它最直接的价值，就是为对象属性提供「防碰撞」的键名：即使多个模块/库都往同一个对象上挂方法或字段，只要用 Symbol 作 key，就几乎不可能覆盖彼此。

用 Symbol 作为对象属性名避免命名冲突

常见场景是第三方库向原生原型（如 Array.prototype）添加工具方法，或框架在用户对象上注入内部状态字段。如果都用字符串名（比如 "_cache"、"__id"），极易发生覆盖。

用 Symbol 就能彻底规避：

const cacheKey = Symbol('cache');
const idKey = Symbol('id');

const obj = {};
obj[cacheKey] = new Map();
obj[idKey] = 123;

// 不会出现在 Object.keys()、for...in、JSON.stringify() 中
console.log(Object.keys(obj)); // []
console.log(JSON.stringify(obj)); // {}

这是因为 Symbol 键默认是「不可枚举」的 —— 它们只对 Object.getOwnPropertySymbols() 和 Reflect.ownKeys() 可见。

全局 Symbol 注册表：Symbol.for() 和 Symbol.keyFor()

普通 Symbol('foo') 每次都新建，互不相等；但如果你需要跨模块共享同一个 Symbol（比如约定某个 Symbol 表示“可序列化”），就得用全局注册表：

• Symbol.for('debug') 查找已注册的 Symbol，不存在则创建并登记
• Symbol.keyFor(sym) 返回该 Symbol 在注册表中的键名（仅对 Symbol.for() 创建的生效）
• 注意：Symbol.for('a') !== Symbol('a') —— 后者永远是私有、孤立的

典型用途：Babel、TypeScript 等工具用 Symbol.for('nodejs.util.inspect.custom') 告知 Node.js 如何自定义对象打印格式。

Symbol 不能替代私有字段，但它是目前最轻量的“弱私有”方案

Symbol 键不是真正私有：通过 Object.getOwnPropertySymbols() 或 Reflect.ownKeys() 仍可枚举出来。它解决的是「意外覆盖」，不是「有意访问」。

如果你需要强封装，ES2025 的 #field 私有字段才是正解；但 Symbol 更早可用、无编译需求、兼容性更好（IE 不支持，但现代环境全覆盖）。实际项目中常组合使用：

• 用 # 字段存核心状态
• 用 Symbol 键挂插件扩展点（如 [Symbol.iterator]）、调试钩子、元信息

最容易忽略的一点：Symbol 描述（description 参数）只是调试用的字符串，不影响唯一性，也不参与比较 —— 所以别指望靠它做逻辑分支。它只出现在 sym.toString() 结果里，比如 Symbol('foo').toString() === 'Symbol(foo)'。