什么是Symbol？Symbol的唯一性-js教程-PHP中文网

Symbol的核心价值在于其唯一性，可避免对象属性命名冲突，实现“私有”属性与元编程。每次调用Symbol()都生成唯一值，即使描述相同也不相等，确保属性键互不覆盖。它不能被for...in、Object.keys()或JSON.stringify()遍历或序列化，但可通过Object.getOwnPropertySymbols()或Reflect.ownKeys()获取，适用于内部状态存储、混入扩展、自定义迭代（如Symbol.iterator）等场景。需注意：Symbol非绝对私有，无法跨域共享（除非用Symbol.for），序列化时会丢失，且在老旧环境存在兼容性问题。

什么是symbol？symbol的唯一性

Symbol，作为JavaScript在ES6中引入的一种新的原始数据类型，它的核心价值在于提供了一种创建独一无二值的方式。你可以把它看作是一个特殊的“标记”，每次你创建一个Symbol，它都保证是独一无二的，即使你给它们相同的描述，它们彼此之间也绝不会相等。这种特性在解决对象属性命名冲突、实现某些元编程行为时显得尤为重要，它让开发者能更安全、更灵活地扩展或定义对象的行为。

解决方案

Symbol的创建非常直接，通过调用

Symbol()

登录后复制

函数即可，例如

const mySymbol = Symbol();

登录后复制

。你也可以在创建时传入一个字符串作为描述（

Symbol('description')

登录后复制

），这个描述只用于调试，方便你在控制台识别它，但并不会影响它的唯一性。也就是说，

Symbol('foo')

登录后复制

和

Symbol('foo')

登录后复制

是两个完全不同的Symbol值。

在实际应用中，Symbol最常见且最强大的用途之一就是作为对象的属性键。传统上，JavaScript对象的属性键只能是字符串或数字。当你在一个对象上添加属性时，如果键名重复，新的值会直接覆盖旧的值。这在大型项目、第三方库集成或者需要向现有对象添加“私有”或不希望被轻易发现的属性时，就容易引发命名冲突。而使用Symbol作为键，由于其天生的唯一性，可以完全避免这种冲突。每个Symbol键都是独一无二的，你可以放心地向任何对象添加Symbol属性，而不用担心会不小心覆盖掉已有的同名字符串属性，或者被其他代码意外覆盖。这为JavaScript对象的扩展提供了一种更健壮、更安全的方式。

Symbol的唯一性如何体现？它解决了什么实际问题？

Symbol的唯一性体现在一个非常核心的层面：每次调用

Symbol()

登录后复制

函数，都会返回一个全新的、独一无二的值。即便你传入相同的字符串描述，比如

Symbol('id') === Symbol('id')

登录后复制

，其结果也永远是

false

登录后复制

。这种“一次性”的唯一性，是它与其他原始数据类型（如字符串，

'a' === 'a'

登录后复制

是

true

登录后复制

）最本质的区别。

这种特性解决了几个实际开发中令人头疼的问题：

首先，对象属性的命名冲突。想象一下，你正在开发一个大型应用，或者使用多个第三方库。每个模块或库都可能需要向一个共享的对象（比如全局配置对象，或者一个DOM元素）添加一些内部状态或元数据。如果大家都用字符串作为键名，比如

'status'

登录后复制

或

'data'

登录后复制

，那么很容易出现一个模块覆盖了另一个模块的属性，导致难以追踪的bug。Symbol的出现，就像是给每个模块发了一把独一无二的“钥匙”，它们可以用自己的Symbol作为键来存储数据，彼此互不干扰。这对于构建健壮、可维护的模块化系统至关重要。

其次，它为实现某种程度的“私有”属性提供了可能。虽然JavaScript中没有真正的私有属性（Symbol属性仍然可以通过

Object.getOwnPropertySymbols()

登录后复制

等方法获取到），但由于Symbol属性不会出现在

for...in

登录后复制

循环、

Object.keys()

登录后复制

或

JSON.stringify()

登录后复制

的结果中，它们在某种程度上是“隐形”的。这使得Symbol非常适合存储那些不希望被外部代码随意修改或发现的内部状态。它提供了一种约定俗成的“私有”机制，让开发者能够更好地封装对象的内部实现细节。

最后，元编程和内置行为的定制。JavaScript本身也大量使用了Symbol来定义一些“众所周知”的Symbol（Well-known Symbols），例如

Symbol.iterator

登录后复制

、

Symbol.hasInstance

登录后复制

等。这些Symbol允许开发者自定义对象的某些内置行为，比如如何被

for...of

登录后复制

循环遍历（通过实现

Symbol.iterator

登录后复制

方法），或者如何判断一个对象是否是某个类的实例（通过

Symbol.hasInstance

登录后复制

）。这为JavaScript的扩展性和灵活性打开了新的大门，让我们能够更深入地控制语言的底层行为。

Symbol与其他数据类型有何不同？它能被遍历吗？

Symbol与其他JavaScript数据类型最根本的不同，在于其值本身的唯一性。字符串、数字、布尔值等原始类型，其值是根据内容来判断相等的；而Symbol则不看内容，只看“出生”，每个

Symbol()

登录后复制

调用都创造了一个新的、独立的个体。即使两个Symbol的描述字符串完全一样，它们在内存中也是两个独立的实体，彼此不相等。这一点是理解Symbol的关键。

至于Symbol属性是否能被遍历，答案是：不能被常规方式遍历，但可以通过特定方法获取。

传统的对象属性遍历方法，比如

for...in

登录后复制

循环和

Object.keys()

登录后复制

，是不会枚举Symbol属性的。这是Symbol设计哲学的一部分，即它们是“隐形”的，不希望被随意发现或遍历。这加强了它们作为内部或“私有”属性的用途。

然而，这并不意味着Symbol属性是完全不可见的。如果你确实需要获取一个对象的所有Symbol属性，JavaScript提供了专门的方法：

Object.getOwnPropertySymbols(obj)
登录后复制
: 这个方法会返回一个数组，包含指定对象自身的所有Symbol属性键。
Reflect.ownKeys(obj)
登录后复制
: 这个方法则更全面，它会返回一个数组，包含对象自身的所有属性键，无论是字符串键还是Symbol键。

举个例子：

const myObj = {
  name: 'Alice',
  [Symbol('id')]: 123,
  [Symbol('secret')]: 'shhh'
};

for (let key in myObj) {
  console.log(key); // 只输出 'name'
}

console.log(Object.keys(myObj)); // 输出 ['name']

console.log(Object.getOwnPropertySymbols(myObj)); // 输出 [Symbol(id), Symbol(secret)]

console.log(Reflect.ownKeys(myObj)); // 输出 ['name', Symbol(id), Symbol(secret)]

登录后复制

这种设计是深思熟虑的：它既保证了Symbol属性的“低可见度”和避免冲突的能力，又在需要时提供了获取这些属性的途径，从而维持了语言的内省能力。

PHP开发实用指南 2.0

对于一个刚进入PHP 开发大门的程序员，最需要的就是一本实用的开发参考书，而不仅仅是各种快速入门的only hello wold。在开发的时候，也要注意到许多技巧和一些“潜规则”。PHP是一门很简单的脚本语言，但是用好它，也要下功夫的。同时，由于PHP 的特性，我一再强调，最NB 的PHP 程序员都不是搞PHP 的。为什么呢？因为PHP 作为一种胶水语言，用于粘合后端数据库和前端页面，更多需

387

查看详情

在实际开发中，Symbol有哪些常见的应用场景和潜在的“坑”？

Symbol在实际开发中，确实有不少精妙的应用，但同时也要警惕一些潜在的“坑”。

常见的应用场景：

为对象添加“私有”或内部属性： 这是最直观的用途。比如，你正在维护一个大型的用户对象，而你希望给这个对象添加一些仅供内部逻辑使用、不希望被外部代码或序列化过程触及的元数据。使用Symbol作为键，就能很好地实现这一点。它们不会被
```
for...in
```
登录后复制
或
```
JSON.stringify()
```
登录后复制
发现，减少了意外操作的风险。
```
const user = {
  name: '张三',
  age: 30
};
const internalId = Symbol('internalId');
user[internalId] = 'u_xyz789'; // 外部不易发现和修改
```
登录后复制
避免命名冲突，尤其是在混入（Mixins）或库开发中： 当你构建一个库，或者使用多个库，它们可能都会往原型链上添加方法或属性。用字符串键，冲突的概率很高。Symbol提供了一种安全的扩展机制。例如，一个库可以定义自己的Symbol作为事件名称或内部钩子，确保不会与其他库的同名字符串事件冲突。
```
// 假设这是库A
const LIBRARY_A_EVENT = Symbol('libraryA.event');
// 假设这是库B
const LIBRARY_B_EVENT = Symbol('libraryB.event');

// 两个库可以安全地监听和触发各自的事件，即使它们描述相同
emitter.on(LIBRARY_A_EVENT, () => console.log('Library A event fired'));
emitter.on(LIBRARY_B_EVENT, () => console.log('Library B event fired'));
```
登录后复制
自定义对象的迭代行为：
```
Symbol.iterator
```
登录后复制
是一个“众所周知”的Symbol。通过给对象添加一个以
```
Symbol.iterator
```
登录后复制
为键的方法，你可以定义该对象如何被
```
for...of
```
登录后复制
循环遍历。这对于实现自定义的数据结构（如链表、树）或者让普通对象也能像数组一样被遍历非常有用。
```
const myCollection = {
  items: [1, 2, 3],
  [Symbol.iterator]: function* () {
    for (const item of this.items) {
      yield item;
    }
  }
};
for (const item of myCollection) {
  console.log(item); // 输出 1, 2, 3
}
```
登录后复制
注册和查找全局共享的Symbol：
```
Symbol.for(key)
```
登录后复制
和
```
Symbol.keyFor(symbol)
```
登录后复制
提供了一种机制，允许你在全局Symbol注册表中创建或获取Symbol。如果你需要跨越多个模块甚至跨iframe共享同一个Symbol，而不仅仅是唯一性，
```
Symbol.for()
```
登录后复制
就派上用场了。它会检查全局注册表，如果存在同名Symbol就返回，否则就创建并注册。

潜在的“坑”：

“私有”性并非绝对： 如前所述，Symbol属性并非真正的私有。它们可以通过
```
Object.getOwnPropertySymbols()
```
登录后复制
或
```
Reflect.ownKeys()
```
登录后复制
被发现和访问。因此，如果你需要严格的数据封装，不能仅仅依赖Symbol。ES2022引入的真正的私有类字段（
```
#privateField
```
登录后复制
）是更好的选择。
序列化问题： Symbol属性在通过
```
JSON.stringify()
```
登录后复制
进行序列化时会被完全忽略。这意味着如果你在一个对象中用Symbol存储了重要数据，而这个对象又需要被转换为JSON进行网络传输或存储，那么这些Symbol属性的值就会丢失。
```
const data = {
  value: 'important',
};
console.log(JSON.stringify(data)); // 输出: {"value":"important"}，Symbol属性丢失
```
登录后复制
解决办法通常是手动提取Symbol属性，或者在序列化前将其转换为字符串键。
调试复杂性： 虽然
```
Symbol('description')
```
登录后复制
中的描述有助于调试，但如果你创建了大量的匿名Symbol（即没有描述的
```
Symbol()
```
登录后复制
），或者在复杂系统中Symbol的使用非常分散，那么在调试时追踪这些Symbol的来源和用途可能会变得有点挑战。控制台只会显示
```
Symbol()
```
登录后复制
，没有上下文信息。
兼容性： 虽然ES6已经普及多年，但如果你的项目需要支持非常老旧的浏览器或运行时环境，Symbol可能不是一个合适的选择，或者需要Babel等工具进行转译。不过，这在现代Web开发中已经不是一个大问题了。