Symbol是JavaScript中唯一且不可变的原始类型，用于创建不冲突的对象属性键；支持局部唯一值、全局注册表（Symbol.for/keyFor）及内置协议实现。

Symbol 是 JavaScript 中一种原始数据类型，专门用来创建唯一、不可变的值，常用于对象属性键，避免命名冲突。

Symbol 的基本用法

调用 Symbol() 函数会返回一个唯一的 Symbol 值，即使描述相同，每次调用也互不相等：

const id1 = Symbol('id');
const id2 = Symbol('id');
console.log(id1 === id2); // false
console.log(id1.toString()); // "Symbol(id)"

作为对象属性名避免冲突

Symbol 作为属性键时不会被 for...in、Object.keys()、JSON.stringify() 等遍历或序列化，适合定义“私有”或内部标识：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

const userId = Symbol('user_id');
const user = {
  name: 'Alice',
  [userId]: 123
};

console.log(Object.keys(user)); // ['name']
console.log(Object.getOwnPropertySymbols(user)); // [Symbol(user_id)]

全局 Symbol 注册表：Symbol.for() 和 Symbol.keyFor()

如果需要跨模块复用同一个 Symbol，可用全局注册表：

立即学习“Java免费学习笔记（深入）”；

• Symbol.for(key)：检查全局注册表中是否存在该 key，有则返回，否则新建并注册
• Symbol.keyFor(sym)：返回已注册 Symbol 对应的 key（仅对 Symbol.for 创建的生效）

const s1 = Symbol.for('debug');
const s2 = Symbol.for('debug');
console.log(s1 === s2); // true
console.log(Symbol.keyFor(s1)); // "debug"

// 注意：Symbol('debug') 不进入注册表，和上面两个都不等

常见使用场景

• 定义类的私有属性（配合 WeakMap 或闭包更稳妥）
• 为第三方对象添加元数据而不污染原有属性
• 实现自定义迭代器（Symbol.iterator）、字符串转义（Symbol.toStringTag）等内置协议
• 在大型项目中统一管理常量键名，防止字符串硬编码导致拼写错误或覆盖