Unity-Editor-Toolbox中PropertyDrawer的NullReferenceException问题解析
在Unity编辑器扩展开发中,PropertyDrawer是一个非常实用的功能,它允许开发者自定义属性在Inspector面板中的显示方式。然而,在使用Unity-Editor-Toolbox项目时,开发者可能会遇到一个特定的NullReferenceException问题,特别是在处理自定义PropertyDrawer时。
问题现象
当开发者使用自定义PropertyDrawer绘制包含列表的属性时,可能会遇到NullReferenceException异常,错误信息指向UnityEditor.EditorGUI+RecycledTextEditor.IsEditingControl方法。这个问题通常表现为:
- 自定义PropertyDrawer无法正常工作
- 控制台显示NullReferenceException错误
- 只有在禁用Unity-Editor-Toolbox的"Use Toolbox Drawers"选项时,PropertyDrawer才能正常工作
问题根源分析
通过分析错误堆栈和代码示例,我们可以确定问题的核心在于PropertyDrawer中的属性修改处理方式。具体来说:
- 错误发生在处理数组大小属性时,表明问题与列表/数组类型的序列化属性有关
- 在自定义PropertyDrawer中直接调用property.serializedObject.ApplyModifiedProperties()可能导致内部状态不一致
- Unity的编辑器GUI系统期望在完整的Inspector绘制周期后才应用属性修改
解决方案
针对这个问题,我们有以下几种解决方案:
1. 移除不必要的ApplyModifiedProperties调用
在PropertyDrawer的OnGUI方法中,不应该直接调用ApplyModifiedProperties()。Unity编辑器会在整个Inspector绘制完成后自动处理属性应用的逻辑。
// 错误做法 - 不应在PropertyDrawer中直接调用
if (EditorGUI.EndChangeCheck())
{
property.serializedObject.ApplyModifiedProperties();
}
2. 正确使用BeginChangeCheck/EndChangeCheck
如果确实需要在特定控件后检查修改,应该成对使用BeginChangeCheck和EndChangeCheck:
EditorGUI.BeginChangeCheck();
// 绘制控件代码...
if (EditorGUI.EndChangeCheck())
{
// 可以在这里标记需要修改,但不直接调用ApplyModifiedProperties
}
3. 优化PropertyDrawer性能
除了解决异常问题外,还可以对PropertyDrawer进行性能优化:
- 缓存频繁使用的数据(如绑定选项)
- 避免在每次OnGUI调用时重新计算不变的数据
- 使用静态变量存储不随实例变化的数据
最佳实践建议
在开发自定义PropertyDrawer时,建议遵循以下最佳实践:
- 避免直接修改序列化对象:让Unity处理属性应用的时机
- 合理使用ChangeCheck:只在需要精确控制修改检测时使用
- 性能优化:缓存计算结果,减少每帧的计算量
- 兼容性考虑:确保PropertyDrawer在不同环境下都能正常工作
- 错误处理:对可能为null的引用进行适当检查
总结
在Unity编辑器扩展开发中,理解PropertyDrawer的工作原理和Unity的序列化机制非常重要。通过避免直接调用ApplyModifiedProperties和正确使用ChangeCheck机制,可以解决大多数与NullReferenceException相关的问题。同时,合理的性能优化可以提升编辑器的响应速度,为开发者提供更好的使用体验。
记住,编辑器脚本虽然强大,但也需要遵循Unity的特定规则和生命周期才能稳定工作。在遇到类似问题时,仔细分析错误堆栈并理解Unity的内部工作机制是解决问题的关键。
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust099- DDeepSeek-V4-ProDeepSeek-V4-Pro(总参数 1.6 万亿,激活 49B)面向复杂推理和高级编程任务,在代码竞赛、数学推理、Agent 工作流等场景表现优异,性能接近国际前沿闭源模型。Python00
MiMo-V2.5-ProMiMo-V2.5-Pro作为旗舰模型,擅⻓处理复杂Agent任务,单次任务可完成近千次⼯具调⽤与⼗余轮上 下⽂压缩。Python00
GLM-5.1GLM-5.1是智谱迄今最智能的旗舰模型,也是目前全球最强的开源模型。GLM-5.1大大提高了代码能力,在完成长程任务方面提升尤为显著。和此前分钟级交互的模型不同,它能够在一次任务中独立、持续工作超过8小时,期间自主规划、执行、自我进化,最终交付完整的工程级成果。Jinja00
Kimi-K2.6Kimi K2.6 是一款开源的原生多模态智能体模型,在长程编码、编码驱动设计、主动自主执行以及群体任务编排等实用能力方面实现了显著提升。Python00
MiniMax-M2.7MiniMax-M2.7 是我们首个深度参与自身进化过程的模型。M2.7 具备构建复杂智能体应用框架的能力,能够借助智能体团队、复杂技能以及动态工具搜索,完成高度精细的生产力任务。Python00