在 ECMAScript 6（ES6）中，JavaScript 引入了一个全新的原始数据类型 —— Symbol。它是 JavaScript 中第 7 种原始类型（加上后来的 BigInt 共计 8 种），其核心特性是“独一无二”，常用于创建对象中不会冲突的属性键。
一、JavaScript 的数据类型概览
JavaScript 共有 8 种数据类型，可划分为两类：
1. 原始（简单）数据类型（7种）
number：数值（包括整数和浮点数）string：字符串boolean：布尔值（true / false）undefined：未定义null：空值（注意：typeof null返回"object"，这是历史遗留 bug）bigint（ES2020 新增）：用于表示任意精度的整数symbol（ES6 新增）：唯一且不可变的值
有趣记忆法：“七上八下”——7 种原始类型 + 1 种引用类型 = 8 种总类型。
2. 复杂（引用）数据类型（1种）
object：对象（包括数组、函数、日期等）
其中，number 和 bigint 可统称为 numeric 类型，但它们互不兼容，不能直接运算。
二、Symbol 是什么？
Symbol 是一种原始数据类型，通过 Symbol() 函数创建。每次调用 Symbol() 都会返回一个全新的、独一无二的值，即使传入相同的描述字符串，结果也不相等。
const id1 = Symbol();
const id2 = Symbol();
console.log(id1 === id2); // false
const s1 = Symbol('二哈');
const s2 = Symbol('二哈');
console.log(s1 === s2); // false
注意：
Symbol()的参数（称为 label 或 description）仅用于调试和识别，不影响 Symbol 的唯一性。
三、Symbol 的声明与使用
1. 声明方式
const sym = Symbol(); // 无描述
const symWithDesc = Symbol('id'); // 带描述
console.log(symWithDesc); // Symbol(id)
⚠️ 不能使用 new 关键字：
// ❌ 报错：Symbol is not a constructor
const s = new Symbol();
这与 BigInt() 类似，都是函数式调用的原始类型构造器。
2. 作为对象的属性键（Key）
Symbol 最重要的用途是作为对象的属性名，避免命名冲突，尤其在多人协作或库开发中非常有用。
const secretKey = Symbol('secret');
const user = {
name: '张三',
email: 'zhang@163.com',
[secretKey]: '123456' // 使用 Symbol 作为 key
};
console.log(user[secretKey]); // '123456'
由于 Symbol 是唯一的，即使其他开发者也定义了同名描述的 Symbol，也不会覆盖你的属性。
四、Symbol 的特性
1. 不可枚举（Non-enumerable）
使用 for...in 或 Object.keys() 无法遍历到 Symbol 键：
const classRoom = {
[Symbol('Mark')]: { grade: 50 },
[Symbol('Oliva')]: { grade: 85 },
dl: ['Mark', 'Oliva']
};
for (const key in classRoom) {
console.log(key); // 只输出 "dl"
}
2. 获取对象中的所有 Symbol 键
需使用 Object.getOwnPropertySymbols(obj)：
const syms = Object.getOwnPropertySymbols(classRoom);
console.log(syms); // [Symbol(Mark), Symbol(Oliva)]
const data = syms.map(sym => classRoom[sym]);
console.log(data);
// [{ grade: 50 }, { grade: 85 }]
3. 不会被 JSON.stringify 序列化
JSON.stringify({ [Symbol('id')]: 123 }); // "{}"
五、为什么需要 Symbol？
在大型项目或多人协作中，对象属性名容易发生命名冲突。例如：
// 开发者 A
user.id = 'A123';
// 开发者 B（不知情）
user.id = 'B456'; // 覆盖了 A 的值！
若使用 Symbol：
const idA = Symbol('id');
const idB = Symbol('id');
user[idA] = 'A123';
user[idB] = 'B456'; // 完全独立，互不干扰
这使得 Symbol 成为实现私有属性或元数据标记的理想选择（尽管 ES2022 已引入真正的私有字段 #field）。
六、注意事项与最佳实践
- Symbol 不是私有属性：虽然不能被常规遍历，但通过
getOwnPropertySymbols仍可访问。 - 描述字符串仅用于调试：不要依赖它做逻辑判断。
- 避免滥用：Symbol 适合解决特定问题（如防冲突、元编程），不是所有属性都需要用 Symbol。
- 全局 Symbol 注册表：若需跨文件共享 Symbol，可使用
Symbol.for('key')和Symbol.keyFor(sym)，但这会牺牲唯一性（相同 key 返回同一 Symbol）。
七、总结
| 特性 | 说明 |
|---|---|
| 类型 | 原始类型（primitive） |
| 唯一性 | 每次 Symbol() 调用都生成新值 |
| 用途 | 对象属性键，避免命名冲突 |
| 枚举性 | 不可被 for...in、Object.keys() 枚举 |
| 序列化 | JSON.stringify 会忽略 Symbol 属性 |
| 调试 | console.log(Symbol('desc')) 显示为 Symbol(desc) |
Symbol 虽小，却在 JavaScript 的类型系统中扮演着独特而关键的角色。掌握它，能让你写出更健壮、更安全的代码，尤其是在构建可复用组件或大型应用时。
正如其名 —— Symbol，象征着独一无二的存在。
