Symbol 是 JavaScript 的第七种原始类型，每次调用 Symbol() 都返回全新且不相等的值，天生不可枚举、不可遍历，适合做私有属性键或防冲突标识符。

Symbol 是什么，为什么它能当唯一标识

Symbol 是 JavaScript 原生的第七种原始类型，每次调用 Symbol() 都会返回一个**全新且不相等**的值，哪怕描述相同。它天生不可枚举、不可遍历、不会被 for...in 或 JSON.stringify 捕获，适合做私有属性键或防冲突的标识符。

用 Symbol() 创建基础唯一标识

最常用方式：直接调用构造函数（注意不能用 new，否则报 TypeError: Symbol is not a constructor）。

const id1 = Symbol('user');
const id2 = Symbol('user');
console.log(id1 === id2); // false
console.log(typeof id1); // "symbol"

• 参数 'user' 是可选描述（description），仅用于调试输出，不影响值的唯一性
• 即使两个 Symbol 描述完全一样，它们也永远不相等
• Symbol 值不能隐式转为字符串，console.log(id1 + '') 会报错；必须显式调用 id1.toString() 或用模板字符串 `${id1}`

用 Symbol.for() 创建全局登记的 Symbol

当你需要跨模块/跨文件复用同一个 Symbol（比如统一的事件名或配置键），就该用 Symbol.for(key)。它会先在全局 Symbol 注册表中查找，存在则返回，否则新建并登记。

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

const s3 = Symbol('debug'); // 注意：没用 .for()
console.log(s1 === s3); // false —— 普通 Symbol 和全局 Symbol 永远不同

• 键名 'debug' 是字符串，会被强制转为字符串（比如 Symbol.for(42) 等价于 Symbol.for('42')）
• 可通过 Symbol.keyFor(s1) 反查登记时用的键名，但对普通 Symbol() 返回 undefined
• 全局注册表是共享的，命名需谨慎，避免第三方库冲突（建议加前缀，如 'myapp:timeout'）

Symbol 作为对象属性键的注意事项

Symbol 作 key 能实现“隐藏但可访问”的属性，但它不会出现在常规遍历中。

立即学习“Java免费学习笔记（深入）”；

const obj = {};
const uid = Symbol('id');
obj[uid] = 123;

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

• 必须用 Object.getOwnPropertySymbols() 才能获取 Symbol 键，Reflect.ownKeys() 也能拿到（它返回所有键，含 Symbol）
• 用 in 操作符或 hasOwnProperty() 判断 Symbol 属性时，结果为 false —— 它们只检查字符串键
• 类的 private field (#id) 更严格（完全无法外部访问），Symbol 是“软私有”，适合插件扩展、元数据标记等场景