1. Symbol 类型的定义与核心特性
1.1 Symbol 的定义
在 JavaScript 中，Symbol 是一种独特的数据类型，专门用于创建独一无二的键。它的核心特性包括唯一性、不可变性、以及不参与常规对象枚举等。简而言之，Symbol 可以让你在对象上定义\"私有化\"的键，而不易与普通属性名发生冲突。
一个 Symbol 值是不可直接被转换为字符串的，通常用于对象属性的键，通过方括号语法像 obj[symbol] 这样访问。Symbol 与字符串键和数字键相互独立，不会互相影响。
1.2 Symbol 的唯一性与不可枚举性
每一个 Symbol 实例都具备全局唯一性，即使传入相同的描述文本也不会相等，除非通过同一次 Symbol() 调用创建。并且Symbol 属性默认不会出现在 for...in、Object.keys 等常规遍历中，这为私有化元数据提供了天然保护。
在对象层面，通过 Symbol 键访问的属性不会被 JSON.stringify 自动序列化，因此也常用于隐藏实现细节或框架内部数据。
1.3 Symbol 的创建方式与全局符号 Registry
你可以使用 Symbol() 创建一个独一无二的符号，或使用 Symbol.for() 将符号放入全局注册表，以便在不同的模块中共享同一个符号。通过 Symbol quelques key（此处为说明性描述）来强调二者差异。
要从全局符号中取回描述文本，可以使用 Symbol.keyFor()；这对于跨模块的插件系统尤其有用。
2. Symbol 的创建方法与全局注册表
2.1 直接创建 Symbol()
直接调用 Symbol() 可以得到一个新的、唯一的符号值，常用于对象属性键的自包含性保证。每次调用 Symbol() 产生的都是不同的符号，即便描述文本相同也不相等。
通过将符号作为对象的属性键，可以实现“私有化字段”的效果，避免与普通字符串键冲突。
// 直接创建 Symbol
const sym1 = Symbol('id');
const obj = {[sym1]: 'secret',name: 'Alice'
};
// 访问
console.log(obj[sym1]); // 'secret'
// 枚举行为
console.log(Object.keys(obj)); // ['name']
// 符号属性只通过 Symbol 访问
console.log(Object.getOwnPropertySymbols(obj)); // [ Symbol(id) ]
2.2 使用 Symbol.for() 的全局注册表
如果你需要在不同模块之间共享同一个符号，可以使用 Symbol.for()，它会在全局注册表中查找已有符号，若不存在则创建并注册。
通过 Symbol.keyFor() 可以从全局符号中提取原始的键名（描述文本），这对跨模块的插件系统非常有帮助。
// 全局注册表中的符号
const sA = Symbol.for('config');
const sB = Symbol.for('config');
console.log(sA === sB); // true
console.log(Symbol.keyFor(sA)); // 'config'
3. Symbol 的典型应用场景
3.1 作为对象属性键，避免冲突
最常见的用法是把 Symbol 作为对象的属性键，以确保不会与普通字符串键冲突。这对于库和框架提供的私有字段非常有用，因为外部遍历或直接使用字符串键都不会访问到这些符号属性。
下面的示例展示了如何使用 Symbol 作为属性键，并保持对外暴露的接口不受影响：
const MY_KEY = Symbol('myKey');
const data = {[MY_KEY]: 42,name: 'Bob'
};// 访问方式仅能通过符号键访问
console.log(data[MY_KEY]); // 42
console.log(data.name); // 'Bob'
// 常规遍历忽略符号键
console.log(Object.keys(data)); // ['name']
// 只列出符号键
console.log(Object.getOwnPropertySymbols(data)); // [ Symbol(myKey) ]
3.2 与迭代协议和内置符号
除了普通键，Symbol 还与语言的内置元数据和协议结合得很好。最常见的就是 Symbol.iterator，用于自定义可迭代对象的行为。
通过实现 [Symbol.iterator]，你可以自定义 for...of 的遍历逻辑，从而让自己的对象像数组一样可迭代。
const myIterable = {*[Symbol.iterator]() {yield 10;yield 20;yield 30;}
};for (const v of myIterable) {console.log(v); // 10, 20, 30
}
3.3 JSON 序列化对 Symbol 的影响
与普通键相比，Symbol 键默认不会参与 JSON 序列化。这使得符号属性成为隐藏元数据的天然入口点，JSON.stringify(obj) 只会序列化普通可枚举属性，符号属性被忽略。
示例中，符号键不会出现在字符串化结果里，这有助于保护敏感信息或实现跨上下文的私有字段。
const obj = { a: 1 };
const sym = Symbol('hidden');
obj[sym] = 2;
console.log(JSON.stringify(obj)); // {"a":1}
3.4 选择使用 Symbol 的注意点与局限
尽管 Symbol 提供了强大的键唯一性，但它也有局限性：调试时需要通过对象的符号键来发现属性，因为常规枚举不可见；以及在某些场景下，过度使用 Symbol 可能使代码可读性下降。
在设计公开 API 时，通常会权衡：是否需要对外暴露元数据、是否需要避免属性名冲突、以及对序列化的影响等因素。
