2026¶

别在真空里调 UI：Prefab Mode 的 UI Environment 机制实测与踩坑日志

实测环境：Unity 2022.3.62f3c1（Windows/macOS 行为一致）。本文所有结论均来自项目内实证，非文档转述。

Odin 序列化与嵌套 Prefab 的已知限制

Odin 官方关于嵌套 Prefab 支持现状的说明。核心结论:Odin 序列化在嵌套 Prefab 场景下仅支持单层覆盖;完整支持是长期未决项目,时间表不确定,甚至可能无法落地。

Odin Inspector 入门与许可证

Odin Inspector and Serializer 是 Sirenix 开发的 Unity 编辑器扩展插件，三大核心能力：

• 提供 100+ **特性（Attribute）**快速增强 Inspector 面板显示。
• 扩展 Unity 原生序列化，支持字典、委托等原生不支持的类型，由开源项目 Odin Serializer 提供。
• 提供一整套自定义 Drawer 系统，深度定制编辑器 GUI，功能非常强大。

Odin Inspector Attributes 特性

ShowInInspector — 调试用，不序列化

仅显示，不写入文件；编辑态改的值不影响 Play 模式；运行时实时刷新值，适合调试。

Odin Inspector 实战案例

案例一：OdinInterfaceReference（序列化接口引用）

设计：自定义 OdinInterfaceReference<TInterface, TObject> 存「实现特定接口的对象」；自定义 Drawer 支持拖拽选择 + 验证圆点；[OdinRequiredInterface] 限定类型。

Odin Inspector 自定义 Drawer

基础概念

继承 OdinValueDrawer<T>，T 为要绘制的字段类型；可借泛型约束获得继承传递性。

Odin Inspector 编辑器窗口

OdinEditorWindow

• 不要重写 OnGUI；注入 GUI 请重写 DrawEditors 或用 [OnInspectorGUI] 特性。
• 必须重写 OnGUI 时务必 base.OnGUI()，否则只剩普通 EditorWindow。
• Odin 默认开启 ScrollView。

Odin Inspector 坑点速查

使用 Odin Inspector 过程中真实踩过的坑，每条附解决方案；文末附提交前自查清单。

Odin Inspector 序列化系统

核心原则

Odin 不覆盖 Unity 序列化，只是扩展它；一个类可同时拥有 Unity 与 Odin 序列化字段。

Odin 强大的序列化只有在直接实现时才生效。