Symbol是JavaScript第七种原始类型，ES6引入，具有唯一、不可变、不可枚举特性，用于避免命名冲突、模拟弱私有成员、定义语义化常量键及通过知名Symbol定制对象底层行为。
Symbol 是 JavaScript 中的第七种原始类型，ES6 引入，用来创建**唯一、不可变、不可枚举**的值。它不是字符串，但可以当对象属性名用；两个描述相同的 Symbol 也不相等，这就从根本上避免了命名冲突。
防止属性名覆盖和污染
当你往别人定义的对象上加字段（比如插件、工具库扩展），用字符串作 key 很容易撞车。Symbol 就是专治这个的：
- 哪怕都叫
Symbol('id')，每次调用都是新值，绝不会相等 - 该属性不会出现在
for...in、Object.keys()、JSON.stringify()中 - 外部代码不持有这个 Symbol 引用，就几乎无法访问该属性
模拟类的私有成员
虽然现在有 #field 私有字段语法，但 Symbol 在旧环境或需要更灵活控制时依然实用：
- 把 Symbol 定义在模块顶层，类内部使用它存敏感数据（如
_balance） - 外部无法通过点号或方括号直接读写，除非你主动暴露 Symbol 或把它传出去
- 比下划线约定更可靠，属于“弱私有”——不是绝对安全，但比命名约定强得多
作为语义化且防误判的常量键
代替字符串定义状态码、动作类型等，避免拼错、重复或意外相等：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
-
const LOADING = Symbol('loading')和const LOADING = 'loading'看似一样，但后者可能被其他模块重复定义或误赋值 - 用 Symbol 做
switch或if判断时，类型安全、无歧义 - 调试时还能看到描述，比如
Symbol.toString()返回"Symbol(loading)"
通过内置 Symbol 定制对象底层行为
JavaScript 提供了一批以 Symbol.xxx 形式存在的“知名 Symbol”，它们是元编程的关键接口：
-
Symbol.iterator：让对象支持for...of -
Symbol.toStringTag：改变Object.prototype.toString.call(obj)的输出 -
Symbol.toPrimitive：控制对象转数字/字符串时的行为（比如+obj或'' + obj） -
Symbol.asyncIterator：支持for await...of（处理异步迭代） -
Symbol.hasInstance：自定义instanceof判定逻辑
基本上就这些。它不复杂，但容易忽略——尤其在封装工具、设计 API 或做兼容性方案时，Symbol 是那种“用了才知道真香”的小而关键的特性。
