Symbol作为属性键能防普通遍历，因其唯一不可枚举，不出现于for...in、Object.keys()等常规遍历中，仅Object.getOwnPropertySymbols()可获取，属“半私有”而非真正私有。
Symbol 作为属性键为什么能防普通遍历
因为 Symbol 创建的值是唯一且不可被枚举的——它不会出现在 for...in、Object.keys()、JSON.stringify() 中，连 Object.getOwnPropertyNames() 都拿不到它，只有 Object.getOwnPropertySymbols() 能显式提取。这使得用 Symbol 命名的属性天然“隐身”于常规访问路径之外。
但注意：它不是真正的私有，Reflect.ownKeys() 和 Object.getOwnPropertySymbols() 仍能发现它，所以只是“半私有”，目标是防止误用，而非对抗恶意探测。
-
Symbol属性不会被解构赋值直接获取：const { secret } = instance拿不到secret（除非你显式写[secretSym]） - 类方法内部可自由使用
this[secretSym]，和普通属性无异 - 多个
Symbol()调用即使描述相同，也互不相等：Symbol('foo') !== Symbol('foo')
在 class 中定义和使用 Symbol 属性的正确姿势
必须把 Symbol 定义在类外部或静态块中，避免每次实例化都新建一个——否则每个实例的 Symbol 键都不一样，无法统一访问逻辑，也失去“约定标识”的意义。
const _id = Symbol('id');
const _token = Symbol('token');
<p>class User {
constructor(id, token) {
this[_id] = id;
this[_token] = token;
}</p><p>getId() {
return this[_id];
}</p><p>// 外部调用 this.id 或 this.token 会是 undefined
}
- 不要在构造函数里写
const _id = Symbol()，那会导致每个实例用不同 key，无法复用逻辑 - 推荐用
const _xxx = Symbol('xxx')方式命名，便于调试时识别用途（DevTools 会显示描述字符串） - 如果需要跨模块共享 Symbol，可用
Symbol.for('key')，但要小心全局命名冲突
和 # 私有字段（Private Fields）的关键区别在哪
#field 是真私有：语法级限制，外部访问直接报错 Uncaught SyntaxError: Private field '#field' must be declared in an enclosing class；而 Symbol 属性是运行时“藏起来”，访问 instance[_sym] 完全合法，只是没人会这么写。
-
#字段不能被in、hasOwnProperty、Reflect.ownKeys检测到；Symbol属性可以被Reflect.ownKeys和Object.getOwnPropertySymbols拿到 -
#不支持计算属性，this[#key]无效；Symbol可以用this[symKey]动态访问 - 兼容性：
#在 Node.js ≥ 12 / Chrome ≥ 74+；Symbol在 IE11 以外基本全覆盖 - 如果你需要子类继承并访问该字段，
Symbol更合适；#字段完全不可继承、不可反射
容易忽略的调试与序列化陷阱
开发时容易以为 “没看到属性就是不存在”，结果在 console.log(instance) 里看不到 Symbol 属性就误判逻辑错误；或者想用 JSON.stringify(instance) 序列化时发现字段丢了，却没意识到这是设计使然。
- 调试时可用
console.log(Object.getOwnPropertySymbols(instance))查看有哪些 Symbol 键 - 若需序列化 Symbol 属性，得手动处理：
JSON.stringify({ ...instance, [_id]: instance[_id] }) - Vue / React 的响应式系统默认不追踪 Symbol 属性（如 Vue 3 的
reactive()），需额外用shallowRef或markRaw配合 - 单元测试中检查 Symbol 属性要用
expect(instance[_sym]).toBe(...)，别依赖toMatchObject——它只看可枚举属性
真正难的不是加个 Symbol，而是团队是否对这种“约定式隐藏”形成共识，以及后续所有序列化、调试、测试环节是否都记得绕过这个盲区。
