Symbol的核心作用是生成局部唯一、不可枚举、不会被意外覆盖的键名；“全局唯一”需用Symbol.for()配合字符串键实现，但其行为与局部Symbol完全不同，混用易出错。
Symbol 类型的核心作用不是“创建全局唯一值”，而是生成**局部唯一、不可枚举、不会被意外覆盖的键名**；所谓“全局唯一”要靠 Symbol.for() 配合字符串键实现，但它和“局部 Symbol”在行为上完全不同，混用会出问题。
Symbol 为什么不能用作普通对象属性的“安全键”？
它能避免属性名冲突，但不等于“绝对安全”。比如：
-
Symbol()每次调用都返回新值，哪怕描述相同：Symbol('a') !== Symbol('a') - 它作为对象属性时默认不可枚举：
Object.keys(obj)、for...in都看不到，但Object.getOwnPropertySymbols(obj)能拿到 - JSON 序列化会直接忽略 Symbol 键：
JSON.stringify({ [Symbol('x')]: 1 })→{}
如何真正创建跨模块共享的“全局 Symbol”？
用 Symbol.for(key)，它会在运行时全局注册表中查找或创建 Symbol。注意：这个“全局”是当前 JavaScript 全局环境（如浏览器 window 或 Node.js global），不是跨 iframe 或跨 Worker 的。
const s1 = Symbol.for('debug');
const s2 = Symbol.for('debug');
console.log(s1 === s2); // true
// 但和 Symbol() 生成的完全无关
const s3 = Symbol('debug');
console.log(s1 === s3); // false
- 键名是字符串，区分大小写：
Symbol.for('ID')≠Symbol.for('id') - 可用
Symbol.keyFor(s)反查注册名，仅对Symbol.for()创建的生效，对Symbol()返回undefined - 不要用复杂或动态拼接的字符串做 key，否则难以维护和调试
实际项目中 Symbol 的典型用途有哪些？
它不是用来替代字符串键的，而是解决特定边界问题：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- 定义对象内部状态字段，防止被外部代码误改或遍历到：
obj[Symbol('cache')] = new Map() - 实现自定义迭代器：
[Symbol.iterator]是 for...of 查找的固定方法名 - 定制
instanceof行为（配合Symbol.hasInstance） - 让类支持
Promise.resolve(obj)（通过Symbol.toStringTag控制Object.prototype.toString.call(obj)输出）
这些场景共同点是：需要一个稳定、不可撞、不参与常规遍历的标识符，而不是“生成一堆随机 ID”。
容易踩的坑：Symbol 不是 UUID 替代品
有人用 Symbol().toString() 截取字符串当唯一 ID，这是错的：
-
Symbol('x').toString()返回"Symbol(x)"，带固定前缀，不是纯随机字符串 - 它不保证跨页面/跨会话唯一，也不适合存数据库或传网络
- 若真需要唯一 ID，请用
crypto.randomUUID()（现代浏览器）或Math.random().toString(36).substr(2, 9)（简易场景）
Symbol 的设计目标很窄：给语言机制和高级库提供“隐式契约键”，不是给业务逻辑发号用的。
