Symbol 是 JavaScript 中唯一、不可变的原始值，用于创建真正私有的对象属性名以解决命名冲突和模拟私有成员；每次调用 Symbol() 都返回全新值，即使描述相同也不相等，仅 Symbol.for() 在全局注册表中复用相同字符串对应的 Symbol。
Symbol 是 JavaScript 中唯一、不可变的原始值，用来创建真正私有的对象属性名，不是“教程”，是实际开发中解决命名冲突和模拟私有成员的核心工具。
Symbol 为什么能保证唯一？
每次调用 Symbol() 都返回一个全新值，即使描述相同，它们也不相等：
const a = Symbol('foo');
const b = Symbol('foo');
console.log(a === b); // false
注意：Symbol.for('key') 是例外——它会检查全局符号注册表，相同字符串返回同一个 Symbol；而普通 Symbol() 永远不复用。
- 普通
Symbol()：适合局部唯一标识（如对象内部状态字段） -
Symbol.for()：适合跨模块共享的特殊标识（如自定义迭代器Symbol.iterator就是预设的全局符号） - 别误以为描述字符串是“名称”——它只用于调试显示，不影响唯一性
怎样用 Symbol 创建真正私有的属性？
对象上用 Symbol 作 key 的属性不会出现在 for...in、Object.keys() 或 JSON.stringify() 中，但可通过 Object.getOwnPropertySymbols() 获取：
立即学习“Java免费学习笔记（深入）”；
const _id = Symbol('id');
const user = { name: 'Alice', [_id]: 123 };
console.log(user[_id]); // 123
console.log(Object.keys(user)); // ['name']
console.log(Object.getOwnPropertySymbols(user)); // [Symbol(id)]
- 不能用点号访问：
user._id无效，必须用方括号user[_id] - 不等于“隐藏”：仍可被反射 API 读取，只是常规遍历不可见
- 多个模块若各自声明
Symbol('id')，仍是不同符号——无法共享，这点常被忽略
哪些内置行为依赖 Symbol？
ES6+ 很多协议方法靠特定 Symbol 触发，比如：
-
Symbol.iterator：让对象可被for...of遍历 -
Symbol.toStringTag：影响Object.prototype.toString.call(x)返回值 -
Symbol.hasInstance：改变instanceof的行为逻辑 -
Symbol.toPrimitive：控制对象转原始值（如 +x、String(x)）
这些不是“魔法”，只是 JS 引擎约定好的钩子名。你也可以定义自己的，但只有引擎识别的那些才会触发对应行为。
Symbol 的坑和限制
Symbol 不是万能私有方案，实际用错很常见：
- 不能作为 JSON 序列化字段：JSON 无视 Symbol key，序列化后直接丢失
- 不能自动转换为字符串：
'' + Symbol()报错，必须显式调用String(sym)或sym.toString() - WeakMap 键可以是 Symbol，但 WeakMap 本身才是更稳妥的私有数据容器——Symbol 只管“键不冲突”，不解决内存泄漏
- 类型判断要小心：
typeof Symbol() === 'symbol'，但旧版浏览器不支持，需检查环境或用 polyfill
真正难的是权衡：用 Symbol 做私有 key，还是用闭包/WeakMap/TypeScript private？这取决于你是否需要跨实例共享、是否要求严格不可枚举、以及运行时兼容性要求。