如何利用 Symbol 为对象添加内部隐藏属性以避免与其他库命名冲突

Symbol作为唯一键能解决属性名冲突和意外覆盖问题：它确保键全局唯一、不可枚举、不参与JSON序列化与for...in遍历，从而避免第三方库用相同字符串键覆盖私有状态。

Symbol 作为唯一键能解决什么实际问题

直接说结论：用 Symbol 给对象加属性，不是为了“隐藏”，而是为了“不可枚举 + 全局唯一”。它不能阻止别人访问（obj[mySym] 依然可读），但能避开 for...in、Object.keys()、JSON.stringify() 的扫描，也几乎不会和第三方库的字符串键撞车。

为什么不能用字符串私有属性名（比如 _xxx）

下划线前缀只是约定，不具强制性。一旦两个库都用了 _id 或 _cache，就会互相覆盖或引发意外行为。而 Symbol('id') 每次调用都生成新值，哪怕描述相同，也不相等：

console.log(Symbol('id') === Symbol('id')); // false

常见踩坑点：

• 误以为 Symbol.for('id') 更安全——其实它会注册到全局符号注册表，反而增加冲突风险，除非你明确需要跨模块共享同一个 Symbol
• 把 Symbol 当作访问控制手段——它不防人，只防遍历和序列化
• 在类中用 Symbol() 做实例私有字段，却忘了每次构造都新建一个 Symbol，导致无法统一访问

如何在类中安全复用同一个 Symbol 键

把 Symbol 定义在类外部或静态属性里，确保所有实例用的是同一个键：

const _cache = Symbol('cache');<br><br>class DataProcessor {<br>  constructor() {<br>    this[_cache] = new Map();<br>  }<br>  get(key) {<br>    return this[_cache].get(key);<br>  }<br>}

关键点：

• 不要在 constructor 或方法体内写 const _cache = Symbol()，否则每个实例的 key 都不同
• 描述字符串（如 'cache'）纯属调试用，不影响唯一性，可空着或写明用途
• 如果需调试，可用 Object.getOwnPropertySymbols(obj) 查看对象上挂了哪些 Symbol 键

Symbol 在实际库开发中的典型用法

主流库（如 Vue、Lodash）用 Symbol 标记内部状态，例如：

• Vue 用 Symbol('vnode') 区分普通对象和虚拟节点
• Lodash 用 Symbol.toStringTag 控制 Object.prototype.toString.call() 返回值
• 自定义迭代器必须返回 [Symbol.iterator]() 方法

注意：Symbol.iterator、Symbol.toStringTag 这些是内置 Symbol，有特殊语义，不要随意覆盖；自定义逻辑一律用 Symbol('xxx')。

真正容易被忽略的是：Symbol 键不会出现在 Object.assign() 的浅拷贝中，也不会被解构赋值捕获（const { [mySym]: x } = obj 语法无效），这些边界行为得提前想到。