🧩 Symbol 是什么？
Symbol 是 ES6（ECMAScript 2015）引入的一种原始数据类型（primitive type） ，用于创建独一无二的值。它是 JavaScript 中第 7 种原始类型（加上 bigint 后共 8 种）。
✅ JavaScript 的 8 种数据类型
| 类型 | 分类 | 说明 |
|---|---|---|
number | 原始 | 数值（含 NaN、Infinity） |
string | 原始 | 字符串 |
boolean | 原始 | true / false |
null | 原始 | 空值（注意：typeof null === 'object' 是历史 bug） |
undefined | 原始 | 未定义 |
symbol | 原始 | 唯一标识符，ES6 新增 |
bigint | 原始 | 任意精度整数，ES2020 新增 |
object | 引用 | 包括数组、函数、日期等 |
📌 口诀：“七上八下”——7 种原始类型 + 1 种引用类型 = 8 种总类型。
🔑 Symbol 的核心特性
1. 独一无二
每次调用 Symbol() 都会返回一个全新的、与其他任何值都不相等的 symbol。
const s1 = Symbol();
const s2 = Symbol();
console.log(s1 === s2); // false
即使传入相同的描述（label），结果也不相等：
const s3 = Symbol('id');
const s4 = Symbol('id');
console.log(s3 === s4); // false
⚠️ 描述（label）仅用于调试（如
console.log(s3)显示Symbol(id)），不影响值的唯一性。2. 可作为对象属性的“私有”键
由于 Symbol 不会被常规遍历方法（如 for...in、Object.keys()）枚举，且不会与其他属性名冲突，常用于模拟“私有属性”或避免命名冲突。
js
编辑
const id = Symbol('userId');
const user = {
name: 'Alice',
[id]: 12345
};
// 普通遍历看不到 Symbol 键
for (let key in user) {
console.log(key); // 只输出 'name'
}
// 但可以通过 getOwnPropertySymbols 获取
console.log(Object.getOwnPropertySymbols(user)); // [Symbol(userId)]
3. 全局 Symbol 注册表：Symbol.for()
如果你希望在不同模块中共享同一个 Symbol，可以使用 Symbol 全局注册表：
const sym1 = Symbol.for('sharedKey');
const sym2 = Symbol.for('sharedKey');
console.log(sym1 === sym2); // true
Symbol.for(key)：先查全局注册表，存在则返回，否则创建并注册。Symbol.keyFor(sym)：反向查找全局注册表中的 key。
console.log(Symbol.keyFor(sym1)); // 'sharedKey'
💡 注意：普通
Symbol('x')不会进入全局注册表，Symbol.keyFor(Symbol('x'))返回undefined。
在 多人协作开发 或 大型项目/库开发 中，Symbol 的一个核心价值就是 避免属性名冲突，从而提升代码的健壮性和可维护性。下面从“公司协作”的角度，具体说明 Symbol 如何发挥作用：
🏢 场景：多人协作开发一个前端框架
假设你们团队正在开发一个 UI 框架（比如类似 Vue 或 React 的组件库），多个开发者同时给组件对象添加内部属性或方法。
❌ 问题：使用字符串作为 key 容易冲突
// 开发者 A
component.internalId = 'comp-001';
// 开发者 B（不知道 A 已经用了 internalId）
component.internalId = 'B-override'; // 覆盖了 A 的值！
// 开发者 C
component._id = 'C-id'; // 试图用下划线约定“私有”，但依然可能被其他人覆盖
即使约定命名规范（如
_xxx、__xxx），也无法强制保证唯一性，容易造成难以排查的 bug。
✅ 解决方案：用 Symbol 作为唯一 key
每个开发者使用自己的 Symbol 作为对象属性的键：
// 开发者 A
const internalId = Symbol('internalId');
component[internalId] = 'comp-001';
// 开发者 B
const debugInfo = Symbol('debugInfo');
component[debugInfo] = { createdBy: 'Bob', time: Date.now() };
// 开发者 C
const privateState = Symbol('privateState');
component[privateState] = { isVisible: true };
✅ 优势：
- 即使描述字符串相同，Symbol 值也不同 → 绝对不冲突
- 外部无法通过常规方式（如
component.internalId）访问 → 一定程度“私有” - 不会被
for...in、JSON.stringify()、Object.keys()暴露 → 减少污染
❗ 注意事项
- Symbol 不能被
new调用（会报错）：new Symbol()❌ - Symbol 不能自动转换为字符串（需显式
.toString()或使用描述） - JSON.stringify() 会忽略 Symbol 属性（包括作为 key 和 value）
JSON.stringify({ [Symbol('id')]: 1, name: 'Bob' }); // '{"name":"Bob"}'
✅ 总结
| 特性 | 说明 |
|---|---|
| 类型 | 原始类型（primitive） |
| 唯一性 | 每次创建都是新值 |
| 用途 | 对象唯一键、避免命名冲突、元编程 |
| 枚举 | 不被 for...in、Object.keys() 枚举 |
| 获取 | Object.getOwnPropertySymbols(obj) |
| 全局共享 | Symbol.for() / Symbol.keyFor() |
