《游戏编辑器技术原理与架构》6.2 域重载与状态保留
域重载会把整个脚本域卸载重装,内存里的状态必须显式序列化才能留下。只有 JSON 可表示的值能过桥,函数与类实例在序列化时被丢弃。恢复策略二选一:keep 保留快照并补默认值,reset 只留默认值。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的域重载状态保留。
category
域重载会把整个脚本域卸载重装,内存里的状态必须显式序列化才能留下。只有 JSON 可表示的值能过桥,函数与类实例在序列化时被丢弃。恢复策略二选一:keep 保留快照并补默认值,reset 只留默认值。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的域重载状态保留。
热重载的最小闭环:找到模块的旧版本、构造新版本、用迁移函数把旧状态搬到新结构、原子替换。迁移失败必须回滚——保留旧模块继续服务,而不是留下一个只换了一半的编辑器。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的脚本热重载。
沙箱是脚本调用编辑器的唯一入口:白名单里的 API 才放行,其余一律抛错;每次放行记一条审计。撤销沙箱后所有调用都失败,用于卸载扩展时立刻切断其能力,而不是等它自己停下来。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的脚本沙箱。
事件总线要满足四个条件:订阅可退订、可只触发一次、可按优先级排序、派发期间结构不变。最后一条靠派发前拍快照实现:回调里新增或退订订阅不影响本轮派发,下一轮才生效,避免遍历数组时改数组的经典 bug。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的编辑器事件回调。
脚本拿到的不是编辑器本身,而是一个按权限裁剪过的上下文:编辑器的只读信息、选择集的副本、以及被授予的那几个方法。上下文对象被冻结,脚本改不掉它,也改不到编辑器内部状态。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的编辑器脚本 API。
场景工具同一时刻只有一个活跃:选择、移动、旋转、缩放手柄,或扩展注册的自定义工具。工具可绑定快捷键,快捷键必须唯一;临时工具用栈压入,松手弹回原工具,例如按住 Alt 临时取色。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的场景工具模式。
网格、参考图、测量线、自定义工具都是叠加层:带 Z 序与可见性,绘制从低 Z 到高 Z,点选从高 Z 往低 Z 找第一个包含点的可见层。工具只关心这两件事,不需要知道渲染器如何实现。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的视口叠加层。
自定义 Gizmo 由若干手柄组成,每个手柄是一条从原点出发的轴段。命中测试算屏幕点到线段的距离,取容差内最近的一条;拖动量把鼠标位移投影到轴方向,垂直分量被丢弃——这就是轴锁定的全部数学。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的Gizmo 手柄扩展。
导入器以插件包形式分发,包里声明依赖的引擎 API 主版本与其他插件。安装器只做三件事:主版本兼容、依赖已安装、同版本幂等;卸载时把依赖它的插件标记为损坏,而不是连带卸载——用户的资产还在,得让他看见问题。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的导入器插件分发。
导入器分探测与导入两步:探测只回答能不能处理,导入才产出产物。管线按注册顺序询问探测,第一个命中者执行;结果带上导入器 id 与版本,写进资产 meta,后续版本升级时据此判断要不要重新导入。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的导入器扩展。
资产类型声明把「扩展名 → 主类型 → 导入器」串起来。同一扩展名可能被多个类型认领,例如普通纹理与图集都读 PNG;解析按优先级取高者,冲突清单则用于安装扩展时提示用户,而不是静默取胜者。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的资产类型声明。
自绘控件想被读屏软件与键盘用户正确使用,必须补齐角色、可读标签与焦点顺序。归一化函数给缺失字段兜底;焦点顺序按 tabIndex 升序,0 保持文档顺序,-1 表示不参与 Tab。属性说明文本的 id 也要有稳定约定,`aria-describedby` 才能指向真实节点。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的编辑器控件可访问性。
资产类型决定 Inspector 的版式。注册表按类型解析,高优先级覆盖低优先级;多选时先按类型分组,再求共同字段的交集,最后逐字段判断值是否相同——不同就是混合值,界面显示破折号,编辑后统一写回。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的资产 Inspector 扩展。
Inspector 为每种属性类型选控件。内核自带默认控件,扩展注册更专用的控件并用优先级覆盖;优先级相同则先注册者胜,保证解析结果稳定。附加条件让同一类型按字段元数据分流,例如带范围的数值用滑块、否则用输入框。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的属性控件扩展。
读完一卷书不等于能改一个编辑器。源码研读清单按难度升序给出入门顺序,并合并所有仓库的关注点做成关键词表——按关键词反查仓库,比按名字猜该读哪个可靠得多。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的源码研读清单。
里程碑带工期与依赖。排序用拓扑序;串行总周数是所有工期之和,关键路径是最长依赖链的工期。两个数字放在一起,才能说明并行能省多少、省不掉多少。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的编辑器路线图。
把全书的十二项能力各打一个成熟度:1 概念可用、2 生产可用、3 工业级。汇总给出总分、平均分与缺口清单,并按等级分组。全景图不评价好坏,只标出下一步该补哪里。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的编辑器能力评估。
测试扩展需要一个最小宿主:安装、激活、调用 API、拆除。安装只管登记,激活才返回它注册的能力;调用要求已激活;teardown 清空所有状态,保证用例之间不串味——扩展测试失败最常见的原因就是上一条用例的残留。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的扩展自动化测试。
把编辑操作录成命令序列(JSON),回放时逐条交给执行器,输出必须与录制时一致;截图回归则把像素数组哈希成短串比较。两条判据都只依赖确定性:同样的命令顺序、同样的像素序列,必须得到同样的哈希。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的命令回放与截图回归。
冒烟用例是一条固定的步骤链:启动、打开项目、放置对象、保存。任何一步失败或超时立即中止,后面的步骤不再执行;报告保留已执行步骤与累计耗时。冒烟不追求覆盖率,只回答编辑器还能不能启动并完成一次基本操作。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的编辑器冒烟测试。