OpenStruct不提供私有变量访问能力，它只是动态属性容器，所有属性默认公开；JSON序列化其对象依赖to_h方法返回哈希，天然绕过可见性检查，与Ruby私有变量封装无关。
opens（openstruct）本身不涉及 json 序列化，也不提供对私有变量的“访问能力”——它只是一个动态属性容器，所有属性默认公开、可读写。所谓“通过 opens 解决 json 序列化库对私有变量的访问”，存在概念混淆：ruby 中没有 opens 指令；你可能指的是 openstruct 类，或误将 java 的 opens 模块指令（java 9+ module system）混入 ruby 场景。
明确 Ruby 中 OpenStruct 的行为边界
OpenStruct 创建的对象本质是哈希驱动的代理对象，它把键值对映射为实例方法。它不支持私有属性，也没有访问控制机制：
- 所有通过
new(key: value)或点号赋值（obj.name = "Alice"）添加的字段，都是公开可读写的实例方法 - 无法定义 Ruby 意义上的私有变量（如
@name被private :name保护），因为 OpenStruct 不使用常规实例变量存储 - JSON 库（如
json标准库）序列化 OpenStruct 时，调用其to_h方法获取键值对，再递归处理 —— 这个过程天然绕过 Ruby 的可见性检查
如果你真正想解决的是“私有实例变量无法被 JSON 序列化”
这是 Ruby 常见问题：标准 JSON.generate(obj) 对普通对象只序列化 to_json 返回值，而默认 to_json 不包含私有实例变量（@xxx）。解决方案不是用 OpenStruct，而是显式控制序列化行为：
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 在类中重写
to_json，手动包含所需私有变量：
def to_json(*args)
{ name: @name, email: @email }.to_json(*args)
end - 使用
as_json钩子（更推荐）：
def as_json(*_)
{ name: @name, email: @email }
end
这样JSON.generate(obj)会自动调用as_json并序列化返回的哈希 - 若需临时暴露私有变量，可用
instance_variables+instance_variable_get构建哈希，但需谨慎过滤（避免序列化敏感字段如@password）
什么时候该考虑 OpenStruct？
OpenStruct 适合快速构建轻量、临时、结构松散的数据载体，例如解析 API 响应后做中间处理：
-
user = OpenStruct.new(name: "Bob", age: 30)→ 可直接user.name访问 - 它天然可被 JSON 库序列化，因为
to_h返回完整哈希，无需额外配置 - 但它不是封装数据模型的工具，不提供验证、默认值、类型约束或访问控制 —— 这些应由自定义类承担
总结关键区别
别把 OpenStruct 当作“绕过私有性的技巧”。它和私有变量根本不在同一抽象层级：
- Ruby 私有变量（
@xxx）属于类封装范畴，受方法可见性规则约束 - OpenStruct 属性是方法代理，无封装意图，也无“私有”概念
- JSON 序列化是否包含某字段，取决于你如何实现
to_json或as_json，而不是靠某种“opens 指令”解锁
