Symbol属性在常规遍历中不可见是设计特性而非bug，它实现逻辑私有；for...in、Object.keys()、Object.getOwnPropertyNames()和JSON.stringify()均忽略Symbol键；需用Object.getOwnPropertySymbols()、Reflect.ownKeys()或方括号显式访问。

Symbol 类型的属性在常规对象遍历中默认不可见，这不是 bug，而是设计特性——它让 Symbol 成为实现“逻辑私有”属性的可靠手段。

Symbol 属性不会出现在 for...in 和 Object.keys() 中

for...in 循环只遍历可枚举的字符串键（包括继承的），完全跳过 Symbol 键；Object.keys() 同样只返回自有、可枚举的字符串键数组，Symbol 键被彻底忽略。

• 即使 Symbol 属性是可枚举的（默认就是），它也不会被这些方法捕获
• Object.getOwnPropertyNames() 也只返回字符串键，无论是否可枚举，依然不包含 Symbol
• JSON.stringify() 序列化时直接丢弃 Symbol 键，结果对象里看不到它们

Symbol 属性需要显式获取

要访问 Symbol 键，必须使用专为此设计的 API：

deep-java-review

Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...

下载

• Object.getOwnPropertySymbols(obj)：返回对象所有自有 Symbol 键组成的数组（按插入顺序）
• Reflect.ownKeys(obj)：一次性返回所有自有键（字符串 + Symbol），顺序符合 ES2015 规范（整数索引 → 字符串键 → Symbol 键）
• 直接用方括号访问：obj[sym] 是最常用且最直接的方式

Symbol 的“不可见”不等于“不可访问”

所谓“不可见”，仅指绕过常规枚举机制，并非真正隐藏：

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

• Symbol 属性仍是对象的自有属性，可通过 Object.hasOwn(obj, sym) 或 'sym in obj' 判断存在性
• 它支持 delete 操作，也能被 Object.defineProperty 修改描述符
• 如果 Symbol 是全局注册的（Symbol.for），其他模块可通过相同 key 获取并访问

完整有序遍历所有自有属性的方法

若需兼顾字符串键与 Symbol 键，并保持标准顺序（整数索引升序 → 其他字符串键插入序 → Symbol 插入序），推荐组合使用：

• 先用 Object.getOwnPropertyNames(obj) 获取字符串键（已按规范排序）
• 再用 Object.getOwnPropertySymbols(obj) 获取 Symbol 键（也按插入顺序）
• 最后合并两个数组，即可得到完整、有序的自有键列表