1. 项目概述为什么你需要掌握自定义属性绘制器如果你在Unity里写过一段时间的脚本尤其是那些需要频繁在Inspector面板上调整参数的脚本你大概率已经对[SerializeField]、[Range]、[Header]这些内置属性Attribute习以为常了。它们确实方便能让你快速组织Inspector的显示。但当你面对一个自定义的类、一个结构体或者一个枚举而Unity默认的绘制方式又丑又难用时那种无力感就上来了。比如你定义了一个WeaponData类里面有攻击力、射速、特效预制体等一堆字段在Inspector里它默认展开成折叠列表每次修改都要点开找起来非常麻烦。又或者你想让一个float字段不仅显示滑动条还能在旁边实时显示一个根据该值计算出的伤害公式结果。这些就是自定义属性绘制器PropertyDrawer和属性特性PropertyAttribute大显身手的地方。简单来说PropertyAttribute是你贴在字段或类上的“标签”它本身不做事只负责“声明意图”——“我这个字段需要特殊对待”。而PropertyDrawer则是这个“标签”对应的“执行者”或“画家”它负责在Inspector里实际画出这个字段的样子。Unity内置的那些[Range]、[Tooltip]背后都对应着一个内置的PropertyDrawer。我们今天要做的就是创建自己的“标签”和“画家”把Inspector面板的布局和交互逻辑牢牢掌握在自己手里。这不仅能极大提升你和你的团队在编辑器下的工作效率更能让复杂系统的配置变得直观、安全且优雅。无论是制作技能编辑器、关卡配置工具还是管理庞大的游戏数据这都是Unity进阶路上必须点亮的技能树。2. 核心概念拆解Attribute与Drawer是如何协作的在深入代码之前我们必须彻底理清PropertyAttribute和PropertyDrawer的关系与工作流程。很多教程只教怎么写却不讲为什么这么写导致一旦遇到复杂情况就无从下手。2.1 PropertyAttribute不仅仅是元数据PropertyAttribute继承自System.Attribute。它的核心作用是“标记”。你可以把它想象成贴在变量上的一个便利贴上面写着给Unity编辑器的“指令”或“提示信息”。这个便利贴本身不会改变变量的值也不会影响运行时的逻辑除非你刻意去读取它。它的生命周期始于编译时并被序列化到程序集的元数据中。创建一个自定义Attribute非常简单using UnityEngine; // 1. 必须继承自PropertyAttribute // 2. 通常以Attribute结尾但使用时可以省略 // 3. 需要添加[System.Serializable]以便序列化但PropertyAttribute本身已可序列化 public class MyCustomAttribute : PropertyAttribute { // 可以在这里定义一些配置参数 public string DisplayName { get; private set; } public float MaxValue { get; private set; } // 构造函数用于初始化这些参数 public MyCustomAttribute(string displayName “Default”, float maxValue 100f) { DisplayName displayName; MaxValue maxValue; } }这个MyCustomAttribute现在就是一个合法的“标签”了。你可以把它贴在任何支持序列化的字段上public class MyComponent : MonoBehaviour { [MyCustomAttribute(“生命值”, 500f)] public float health; // 使用时的简写省略“Attribute”后缀 [MyCustom(“攻击力”, 999f)] public float attackPower; }此时如果你运行游戏Inspector里这两个字段的显示不会有任何变化。因为Unity只知道这里有个MyCustom标签但并不知道该如何根据这个标签来绘制字段。这就是PropertyDrawer出场的时候了。注意PropertyAttribute的构造函数参数只能是基本常量类型如int,float,string,bool或者System.Type。不能传递对象实例、数组等复杂数据。这是因为Attribute的信息是在编译时就被确定的。2.2 PropertyDrawerInspector的画笔PropertyDrawer继承自UnityEditor.PropertyDrawer注意命名空间是UnityEditor这意味着它只在编辑器下生效。它的核心使命是给定一个序列化属性SerializedProperty和一个区域Rect在这个区域里画出你想要的UI。Unity编辑器内部有一个“绘制器查找表”。当你打开一个包含被标记字段的Inspector时Unity会找到这个字段对应的SerializedProperty。检查该字段上是否有PropertyAttribute。如果有就去查找注册的PropertyDrawer中有没有哪个能处理这个特定的Attribute类型。找到后就将绘制工作委托给这个PropertyDrawer的OnGUI方法。关联PropertyDrawer和PropertyAttribute的关键是给PropertyDrawer类添加[CustomPropertyDrawer(typeof(YourAttribute))]这个Attribute。using UnityEditor; using UnityEngine; // 关键使用CustomPropertyDrawer特性关联到我们自定义的Attribute [CustomPropertyDrawer(typeof(MyCustomAttribute))] public class MyCustomDrawer : PropertyDrawer { // 核心方法如何绘制属性 public override void OnGUI(Rect position, SerializedProperty property, GUIContent label) { // 1. 获取我们定义的Attribute实例 MyCustomAttribute myAttr attribute as MyCustomAttribute; // 2. 修改标签文本 label.text myAttr.DisplayName; // 3. 根据字段类型进行绘制 if (property.propertyType SerializedPropertyType.Float) { // 使用Slider绘制最大值来自Attribute参数 property.floatValue EditorGUI.Slider(position, label, property.floatValue, 0f, myAttr.MaxValue); } else { // 如果不支持的类型回退到默认绘制并给出警告 EditorGUI.LabelField(position, label.text, “不支持的字段类型”); // 或者调用基类方法绘制默认UI // base.OnGUI(position, property, label); } } // 可选返回此属性绘制所需的高度 public override float GetPropertyHeight(SerializedProperty property, GUIContent label) { // 通常返回一行的高度如果需要多行UI则计算总高度 return EditorGUIUtility.singleLineHeight; } }现在你再去看Inspectorhealth和attackPower字段就会显示为带有自定义标签名和最大值的滑动条了。整个协作流程可以概括为Attribute定义“要做什么”WhatDrawer定义“怎么做”How。2.3 SerializedProperty编辑器与数据的桥梁在PropertyDrawer的OnGUI方法中第三个参数SerializedProperty property是核心操作对象。它不是字段的运行时值而是Unity序列化系统对那个字段的一个“引用”或“代理”。通过它你可以安全地读取和修改序列化字段的值并且能自动处理撤销Undo、预制件覆盖Prefab Override等编辑器功能。你需要根据property.propertyType来判断字段的底层类型然后使用对应的方法property.intValue,property.floatValue,property.stringValue用于基本类型。property.objectReferenceValue用于引用类型如GameObject,ScriptableObject。property.vector3Value用于Vector3等Unity结构体。property.enumValueIndex用于枚举获取的是索引通常需要转换。对于数组或列表使用property.arraySize和property.GetArrayElementAtIndex(index)。一个至关重要的细节在OnGUI中你应该使用EditorGUI或EditorGUILayout提供的方法来绘制UI并直接赋值给property.XXXValue。例如property.floatValue EditorGUI.Slider(...)。这样赋值Unity的序列化系统才能捕获到变化。切忌先从一个临时变量读取绘制完再赋值这可能会丢失中间帧的编辑状态。3. 实战进阶从简单到复杂的绘制器实现理解了基本原理后我们通过几个由浅入深的例子来看看如何应对实际开发中的各种需求。我会在每个例子中穿插我踩过的坑和总结的技巧。3.1 案例一为枚举添加颜色标签与图标Unity默认的枚举下拉菜单是黑白的当枚举项很多且代表不同状态时比如物品品质普通、稀有、史诗、传说辨识度很低。我们想为每个枚举值附加一个颜色和图标。首先定义Attribute用于存储颜色和图标路径或直接引用public class EnumStyleAttribute : PropertyAttribute { public readonly string[] Colors; public readonly string[] IconNames; // 假设图标在特定Resources路径下 public EnumStyleAttribute(string[] colors, string[] iconNames) { Colors colors; IconNames iconNames; } }在组件上使用public class Item : MonoBehaviour { [EnumStyle(new string[] { “#808080”, “#1E90FF”, “#9370DB”, “#FFD700” }, new string[] { “icon_common”, “icon_rare”, “icon_epic”, “icon_legend” })] public ItemRarity rarity; } public enum ItemRarity { Common, Rare, Epic, Legendary }接下来是复杂的Drawer实现。我们不能简单地画一个下拉菜单而是要自己绘制一个带颜色的按钮式选择器。[CustomPropertyDrawer(typeof(EnumStyleAttribute))] public class EnumStyleDrawer : PropertyDrawer { public override void OnGUI(Rect position, SerializedProperty property, GUIContent label) { EnumStyleAttribute styleAttr attribute as EnumStyleAttribute; if (property.propertyType ! SerializedPropertyType.Enum) { EditorGUI.HelpBox(position, “EnumStyleAttribute 只能用于枚举类型”, MessageType.Error); return; } // 获取当前枚举类型和值 Type enumType fieldInfo.FieldType; string[] enumNames property.enumDisplayNames; int currentIndex property.enumValueIndex; // 计算每个按钮的宽度 float buttonWidth position.width / enumNames.Length; Rect buttonRect new Rect(position.x, position.y, buttonWidth, position.height); EditorGUI.LabelField(new Rect(position.x, position.y, EditorGUIUtility.labelWidth, position.height), label); // 绘制标签后的区域 Rect buttonsRect new Rect(position.x EditorGUIUtility.labelWidth, position.y, position.width - EditorGUIUtility.labelWidth, position.height); buttonWidth buttonsRect.width / enumNames.Length; buttonRect new Rect(buttonsRect.x, buttonsRect.y, buttonWidth, buttonsRect.height); // 为每个枚举值绘制一个带颜色的按钮 for (int i 0; i enumNames.Length; i) { // 解析颜色 Color originalColor GUI.color; if (ColorUtility.TryParseHtmlString(styleAttr.Colors[i], out Color btnColor)) { GUI.color btnColor; } // 设置按钮样式当前选中的高亮 GUIStyle buttonStyle new GUIStyle(EditorStyles.miniButtonMid); if (i currentIndex) { buttonStyle.fontStyle FontStyle.Bold; buttonStyle.normal.textColor Color.white; } // 绘制按钮 if (GUI.Button(buttonRect, enumNames[i], buttonStyle)) { property.enumValueIndex i; property.serializedObject.ApplyModifiedProperties(); } // 这里可以添加加载并绘制图标的逻辑略复杂需缓存Texture2D // ... GUI.color originalColor; buttonRect.x buttonWidth; } } public override float GetPropertyHeight(SerializedProperty property, GUIContent label) { // 只需要一行高度 return EditorGUIUtility.singleLineHeight; } }实操心得性能注意在OnGUI中频繁加载资源如Resources.Load图标是性能杀手。正确的做法是在Drawer的静态构造函数或初始化方法中加载并缓存这些资源或者使用EditorGUIUtility.Load配合AssetDatabase。布局计算手动计算Rect是精细控制UI布局的基础。EditorGUIUtility.labelWidth是Unity为字段标签预留的宽度使用它能让你的自定义绘制器与内置字段对齐看起来更协调。撤销支持我们的代码在按钮点击时直接修改了property.enumValueIndex并调用了ApplyModifiedProperties()。但更规范的做法是使用EditorGUI.BeginChangeCheck()和EditorGUI.EndChangeCheck()包裹赋值逻辑这样能获得更好的撤销/重做支持。3.2 案例二创建可折叠的复杂结构体绘制器默认情况下自定义结构体struct在Inspector里会展开所有字段占用大量空间。我们希望为某些复杂的结构体如AttackModifier包含伤害类型、倍率、持续时间等提供一个可折叠、且内部布局更紧凑的绘制方式。首先定义结构体和Attribute[System.Serializable] public struct AttackModifier { public DamageType damageType; public float multiplier; public float duration; public bool isPercentage; } public enum DamageType { Fire, Ice, Lightning, Physical } // 这个Attribute用于标记希望用自定义折叠方式绘制的结构体字段 public class FoldoutStructAttribute : PropertyAttribute { public string DisplayName { get; private set; } public FoldoutStructAttribute(string displayName null) { DisplayName displayName; } }Drawer的实现需要处理折叠状态和递归绘制子属性[CustomPropertyDrawer(typeof(FoldoutStructAttribute))] public class FoldoutStructDrawer : PropertyDrawer { // 使用字典来保存每个属性实例的折叠状态Key由对象实例ID和属性路径生成确保唯一性 private static Dictionarystring, bool s_foldoutStates new Dictionarystring, bool(); public override void OnGUI(Rect position, SerializedProperty property, GUIContent label) { FoldoutStructAttribute attr attribute as FoldoutStructAttribute; string displayName string.IsNullOrEmpty(attr.DisplayName) ? label.text : attr.DisplayName; // 生成一个唯一Key来存储折叠状态 string key $“{property.serializedObject.targetObject.GetInstanceID()}.{property.propertyPath}”; if (!s_foldoutStates.ContainsKey(key)) { s_foldoutStates[key] false; // 默认折叠 } // 1. 绘制折叠标题栏 Rect foldoutRect new Rect(position.x, position.y, position.width, EditorGUIUtility.singleLineHeight); s_foldoutStates[key] EditorGUI.Foldout(foldoutRect, s_foldoutStates[key], displayName, true); if (!s_foldoutStates[key]) { // 如果折叠只显示标题高度就是一行 return; } // 2. 展开后绘制结构体内部的所有子属性 EditorGUI.indentLevel; float lineHeight EditorGUIUtility.singleLineHeight; float verticalSpacing EditorGUIUtility.standardVerticalSpacing; float currentY position.y lineHeight verticalSpacing; // 遍历结构体的所有子属性 SerializedProperty child property.Copy(); SerializedProperty end property.GetEndProperty(); bool enterChildren true; while (child.NextVisible(enterChildren) !SerializedProperty.EqualContents(child, end)) { enterChildren false; float childHeight EditorGUI.GetPropertyHeight(child, true); Rect childRect new Rect(position.x, currentY, position.width, childHeight); EditorGUI.PropertyField(childRect, child, true); currentY childHeight verticalSpacing; } EditorGUI.indentLevel--; } public override float GetPropertyHeight(SerializedProperty property, GUIContent label) { FoldoutStructAttribute attr attribute as FoldoutStructAttribute; string key $“{property.serializedObject.targetObject.GetInstanceID()}.{property.propertyPath}”; if (!s_foldoutStates.ContainsKey(key) || !s_foldoutStates[key]) { // 折叠状态高度为一行 return EditorGUIUtility.singleLineHeight; } // 展开状态计算所有子属性的总高度 float totalHeight EditorGUIUtility.singleLineHeight EditorGUIUtility.standardVerticalSpacing; SerializedProperty child property.Copy(); SerializedProperty end property.GetEndProperty(); bool enterChildren true; while (child.NextVisible(enterChildren) !SerializedProperty.EqualContents(child, end)) { enterChildren false; totalHeight EditorGUI.GetPropertyHeight(child, true) EditorGUIUtility.standardVerticalSpacing; } // 减去最后一个多余的间距 totalHeight - EditorGUIUtility.standardVerticalSpacing; return totalHeight; } }踩坑记录与技巧折叠状态管理折叠状态bool不能直接作为Drawer的成员变量因为同一个Drawer实例可能用于绘制场景中多个对象的同一个字段。必须使用一个以属性路径和目标对象实例ID组合成的唯一键来存储在静态字典中。property.propertyPath给出了从根对象到该属性的完整路径结合对象ID可以精确区分每一个被绘制的属性实例。遍历子属性SerializedProperty.Copy()和NextVisible()是遍历所有子属性的标准模式。GetEndProperty()获取一个“结束标记”用于判断遍历何时停止。enterChildren参数控制是否进入数组或嵌套结构的内部。高度计算GetPropertyHeight必须与OnGUI中的绘制逻辑严格对应。在展开状态下需要递归计算所有子属性的高度。使用EditorGUI.GetPropertyHeight(child, true)可以自动获得包含子项的高度这是最可靠的方法。缩进管理在绘制子属性前增加EditorGUI.indentLevel绘制完后恢复可以让子属性正确缩进符合Unity的视觉习惯。3.3 案例三实现一个关联资源与预览的Asset引用绘制器Unity默认的ObjectField可以拖入资源但有时我们想增强它。例如一个“音效”字段拖入AudioClip后希望在Inspector里直接显示一个播放/停止按钮或者一个“纹理”字段旁边能显示一个小预览图。这个例子我们实现一个带预览图的纹理引用绘制器。public class PreviewTextureAttribute : PropertyAttribute { public float PreviewHeight { get; private set; } public PreviewTextureAttribute(float previewHeight 64f) { PreviewHeight previewHeight; } } [CustomPropertyDrawer(typeof(PreviewTextureAttribute))] public class PreviewTextureDrawer : PropertyDrawer { public override void OnGUI(Rect position, SerializedProperty property, GUIContent label) { if (property.propertyType ! SerializedPropertyType.ObjectReference) { EditorGUI.HelpBox(position, “PreviewTextureAttribute 只能用于Object引用类型”, MessageType.Error); return; } PreviewTextureAttribute attr attribute as PreviewTextureAttribute; float lineHeight EditorGUIUtility.singleLineHeight; float spacing EditorGUIUtility.standardVerticalSpacing; // 第一行标签和Object字段 Rect objectFieldRect new Rect(position.x, position.y, position.width, lineHeight); EditorGUI.ObjectField(objectFieldRect, property, typeof(Texture), label); // 如果当前有引用并且是Texture类型则绘制预览 Texture texture property.objectReferenceValue as Texture; if (texture ! null) { float previewY position.y lineHeight spacing; Rect previewRect new Rect(position.x, previewY, position.width, attr.PreviewHeight); // 绘制一个背景框 EditorGUI.DrawRect(previewRect, new Color(0.15f, 0.15f, 0.15f, 0.9f)); // 计算保持比例的预览区域 float aspectRatio (float)texture.width / texture.height; float previewWidth attr.PreviewHeight * aspectRatio; if (previewWidth position.width) { previewWidth position.width; attr.PreviewHeight previewWidth / aspectRatio; } Rect imageRect new Rect( position.x (position.width - previewWidth) * 0.5f, previewY (attr.PreviewHeight - attr.PreviewHeight) * 0.5f, // 垂直居中 previewWidth, attr.PreviewHeight ); // 绘制纹理 GUI.DrawTexture(imageRect, texture, ScaleMode.ScaleToFit); // 可选在预览图上方或下方显示纹理信息 Rect infoRect new Rect(position.x, previewY attr.PreviewHeight 2f, position.width, lineHeight); EditorGUI.LabelField(infoRect, $“{texture.width}x{texture.height} | {GetTextureFormatInfo(texture)}”, EditorStyles.centeredGreyMiniLabel); } } public override float GetPropertyHeight(SerializedProperty property, GUIContent label) { PreviewTextureAttribute attr attribute as PreviewTextureAttribute; float baseHeight EditorGUIUtility.singleLineHeight EditorGUIUtility.standardVerticalSpacing; if (property.objectReferenceValue as Texture ! null) { // 基础高度 预览图高度 信息标签高度 间距 return baseHeight attr.PreviewHeight EditorGUIUtility.singleLineHeight EditorGUIUtility.standardVerticalSpacing; } return baseHeight - EditorGUIUtility.standardVerticalSpacing; // 没有预览时只有一行 } private string GetTextureFormatInfo(Texture texture) { // 注意Texture.format是运行时API在编辑器下可能无法直接获取。 // 更可靠的方式是通过AssetDatabase和TextureImporter来获取信息。 // 这里简化处理实际使用时需要更复杂的逻辑。 return “RGB24”; // 示例 } }注意事项编辑器与运行时API在PropertyDrawer中你处于编辑器环境下可以自由使用EditorGUI、AssetDatabase等UnityEditor命名空间下的类。但要注意像Texture.format这样的属性在未加载的纹理上可能无法访问。对于复杂的资源信息获取可能需要通过AssetImporter如TextureImporter来查询。性能与重绘在OnGUI中绘制纹理预览是相对昂贵的操作尤其是预览图较大时。要确保GetPropertyHeight计算准确避免不必要的布局变化导致频繁重绘。对于非常复杂的预览如模型预览可以考虑使用EditorGUI.DrawPreviewTexture或更底层的Handles/GL绘图但这需要更深入的知识。泛用性这个Drawer目前只检查Texture。你可以修改ObjectField的接受类型和检查逻辑使其适用于AudioClip显示波形图、Material显示小球预览等多种资源原理是相通的。4. 高级技巧与性能优化当你开始大规模使用自定义绘制器时一些高级技巧和性能考量就变得至关重要。4.1 绘制器缓存与序列化数据管理PropertyDrawer的实例由Unity编辑器管理其生命周期并不完全由你控制。因此切忌在Drawer中存储与特定属性实例相关的状态比如输入框的临时字符串、滚动位置等。这些状态应该存储在序列化系统能够管理的地方。正确做法使用SerializedProperty本身来存储状态或者使用SerializedObject的FindProperty找到相关的“隐藏”属性。例如如果你想为一个字符串字段添加一个“编辑”按钮点击后展开一个大文本框这个“是否展开”的状态应该存储在该组件脚本的另一个bool序列化字段中并通过property.serializedObject.FindProperty(“myFoldoutState”)来获取和修改。对于需要复杂计算的数据如预览图的渲染结果可以考虑使用静态字典配合唯一键进行缓存但要注意及时清理无效的缓存项防止内存泄漏。键的生成可以结合property.serializedObject.targetObject.GetInstanceID()和property.propertyPath。4.2 处理数组与列表中的自定义绘制当你把自定义Attribute应用在数组或ListT的元素上时绘制器需要能正确处理。好消息是Unity会自动为数组中的每个元素调用对应的Drawer。但这里有个关键点property参数代表的是数组中的那个元素属性。在Drawer的OnGUI里property就是序列化数组中当前索引处的元素。你可以像操作单个字段一样操作它。GetPropertyHeight也同样被用于计算每个元素的高度。这使得为数组内的复杂结构创建美观的UI成为可能比如一个ListAttackModifier每个元素都显示为可折叠的卡片。一个常见需求自定义数组标题行。你可能想在整个数组上方添加一个自定义的按钮。这需要通过一个自定义的PropertyDrawer来绘制整个数组property.propertyType SerializedPropertyType.Generic且property.isArray为true但这属于更高级的CustomEditor范畴通常结合ReorderableList来实现已经超出了基础PropertyDrawer的范围。对于数组内元素的自定义PropertyDrawer完全胜任对于整个列表容器的自定义则需要考虑Editor脚本。4.3 与CustomEditor的协作与区分PropertyDrawer和CustomEditor为整个MonoBehaviour或ScriptableObject自定义Inspector都是扩展编辑器UI的工具但分工不同PropertyDrawer字段级。它只关心某一个特定的字段如何绘制。职责单一可复用性极高。一旦定义好任何使用了该Attribute的字段无论在哪个脚本里都会自动应用这个绘制方式。CustomEditor组件/资源级。它控制整个Inspector的布局。你可以在OnInspectorGUI中完全重排所有字段添加按钮、绘制曲线、创建复杂的标签页系统等。CustomEditor功能更强大但它是针对特定组件类型的复用性不如PropertyDrawer。最佳实践优先使用PropertyDrawer。只有当需要对整个Inspector进行大刀阔斧的改造或者需要协调多个字段之间的联动UI时才使用CustomEditor。在CustomEditor的OnInspectorGUI中你仍然可以调用EditorGUILayout.PropertyField(serializedObject.FindProperty(“myField”), true)来绘制字段而这个字段如果带有自定义的PropertyDrawer它的自定义绘制效果依然会显示出来两者可以和谐共存。5. 调试、排查与常见问题实录即使理解了所有原理在实际编写复杂Drawer时你依然会遇到各种诡异的问题。下面是我在项目中积累的一些典型问题及其解决方法。5.1 绘制器不生效检查清单脚本编译确保你的Drawer脚本放在Editor文件夹下或任意以Editor命名的文件夹中。只有放在Editor文件夹下的脚本才会在Unity编辑器中被编译运行时不会包含。这是最常见的错误。Attribute与Drawer关联检查[CustomPropertyDrawer(typeof(YourAttribute))]中的typeof参数是否完全匹配你的Attribute类名包括命名空间。字段类型匹配在Drawer的OnGUI开头检查property.propertyType是否是你期望的类型。一个为float设计的Drawer被用在int字段上就会出错。可以使用EditorGUI.HelpBox显示友好的错误信息。序列化支持确保你应用Attribute的字段是可序列化的public或带有[SerializeField]的private/protected字段。非序列化字段不会出现在Inspector中Drawer自然无效。编辑器刷新有时修改了Drawer代码后Inspector没有立即更新。尝试点击一下Inspector窗口的标题栏或者在Project窗口中点击任意一个脚本强制编辑器刷新所有自定义绘制器。5.2 布局错乱与高度计算陷阱GetPropertyHeight返回的高度必须与OnGUI中实际绘制的区域高度严格一致。如果高度计算偏小部分UI会被裁剪如果偏大会出现难看的空白区域并可能影响后续元素的布局。调试技巧在开发阶段可以临时在GetPropertyHeight中返回一个固定值比如100然后在OnGUI中用GUI.Box或EditorGUI.DrawRect为你的绘制区域画上不同颜色的背景直观地看到Unity为你分配的区域和你实际使用的区域是否匹配。另一个常见问题是未考虑间距。EditorGUIUtility.singleLineHeight是标准行高EditorGUIUtility.standardVerticalSpacing是标准垂直间距。在计算多行布局的总高度时别忘了在行与行之间加上间距但最后一行之后通常不加。5.3 撤销Undo操作失效如果你在Drawer中直接修改了property.XXXValueUnity的序列化系统通常会为你自动处理撤销。但是如果你在修改前后进行了复杂的逻辑判断或者修改了多个关联属性为了确保撤销操作的正确性应该使用标准模式public override void OnGUI(Rect position, SerializedProperty property, GUIContent label) { EditorGUI.BeginChangeCheck(); // 开始变更检查 // ... 你的绘制逻辑最终会修改property的值 ... float newValue EditorGUI.Slider(position, label, property.floatValue, 0, 10); if (EditorGUI.EndChangeCheck()) // 如果检测到变更 { property.floatValue newValue; // 赋值 property.serializedObject.ApplyModifiedProperties(); // 应用修改 } // 如果还有修改其他关联属性也放在EndChangeCheck块内 }EditorGUI.BeginChangeCheck()和EditorGUI.EndChangeCheck()会记录UI操作确保任何修改都能被正确地纳入一次撤销操作中。5.4 处理多对象编辑Multi-Object Editing当在场景中同时选中多个具有相同脚本的GameObject进行编辑时Inspector会进入多对象编辑模式。你的Drawer也需要能正确处理这种情况。值不一致显示当选中的多个对象在该字段上的值不同时property会显示一个“混合值”。EditorGUI控件如Slider、TextField大多能自动处理显示为空白或特殊标识。你在绘制时应避免在这种情况下显示一个确定的值。修改操作当你通过UI修改了字段这个修改会应用到所有选中的对象上。这是由property.serializedObject.ApplyModifiedProperties()自动完成的你一般不需要额外处理。自定义控件的注意事项如果你自己绘制了一个非标准的控件比如一套按钮在修改值之前最好检查property.hasMultipleDifferentValues。如果为true你可能需要设计特殊的交互比如点击按钮后是清除混合状态设置为统一值还是弹出一个对话框让用户选择。5.5 性能问题分析与优化复杂的Drawer尤其是那些包含纹理预览、实时计算或大量布局计算的可能会拖慢Inspector的响应速度。避免在OnGUI中执行昂贵操作如数据库查询、复杂的物理计算、频繁的Resources.Load或AssetDatabase.LoadAssetAtPath。这些操作的结果应该被缓存。减少不必要的重绘OnGUI每帧都可能被调用多次。确保你的绘制逻辑是轻量级的。对于基于时间的动画或预览考虑使用EditorApplication.update委托来驱动并只在数据变化时请求重绘EditorUtility.SetDirty。优化GetPropertyHeight这个方法的调用频率可能比OnGUI还高。确保它的计算尽可能快避免在这里进行复杂的遍历或计算。如果高度是固定的或依赖于一个简单属性直接返回缓存的值。使用GUILayout的权衡我们的例子大多使用基于Rect的EditorGUI因为布局精确。EditorGUILayout虽然方便但它在幕后也需要计算布局对于复杂或动态高度的UI有时反而更难控制性能。在自定义Drawer中我通常更推荐使用EditorGUI进行显式布局。最后分享一个我个人的习惯为每一个复杂的自定义Drawer创建一个专门的测试脚本和测试场景。在这个测试脚本中暴露各种边界情况空值、极值、数组、嵌套的字段然后观察Drawer的行为。这比在真实项目中调试要高效得多也能确保你的绘制器足够健壮。自定义属性绘制器是Unity编辑器扩展的基石花时间掌握它你打造的工具和工作流将产生质的飞跃。
1. 项目概述为什么你需要掌握自定义属性绘制器如果你在Unity里写过一段时间的脚本尤其是那些需要频繁在Inspector面板上调整参数的脚本你大概率已经对[SerializeField]、[Range]、[Header]这些内置属性Attribute习以为常了。它们确实方便能让你快速组织Inspector的显示。但当你面对一个自定义的类、一个结构体或者一个枚举而Unity默认的绘制方式又丑又难用时那种无力感就上来了。比如你定义了一个WeaponData类里面有攻击力、射速、特效预制体等一堆字段在Inspector里它默认展开成折叠列表每次修改都要点开找起来非常麻烦。又或者你想让一个float字段不仅显示滑动条还能在旁边实时显示一个根据该值计算出的伤害公式结果。这些就是自定义属性绘制器PropertyDrawer和属性特性PropertyAttribute大显身手的地方。简单来说PropertyAttribute是你贴在字段或类上的“标签”它本身不做事只负责“声明意图”——“我这个字段需要特殊对待”。而PropertyDrawer则是这个“标签”对应的“执行者”或“画家”它负责在Inspector里实际画出这个字段的样子。Unity内置的那些[Range]、[Tooltip]背后都对应着一个内置的PropertyDrawer。我们今天要做的就是创建自己的“标签”和“画家”把Inspector面板的布局和交互逻辑牢牢掌握在自己手里。这不仅能极大提升你和你的团队在编辑器下的工作效率更能让复杂系统的配置变得直观、安全且优雅。无论是制作技能编辑器、关卡配置工具还是管理庞大的游戏数据这都是Unity进阶路上必须点亮的技能树。2. 核心概念拆解Attribute与Drawer是如何协作的在深入代码之前我们必须彻底理清PropertyAttribute和PropertyDrawer的关系与工作流程。很多教程只教怎么写却不讲为什么这么写导致一旦遇到复杂情况就无从下手。2.1 PropertyAttribute不仅仅是元数据PropertyAttribute继承自System.Attribute。它的核心作用是“标记”。你可以把它想象成贴在变量上的一个便利贴上面写着给Unity编辑器的“指令”或“提示信息”。这个便利贴本身不会改变变量的值也不会影响运行时的逻辑除非你刻意去读取它。它的生命周期始于编译时并被序列化到程序集的元数据中。创建一个自定义Attribute非常简单using UnityEngine; // 1. 必须继承自PropertyAttribute // 2. 通常以Attribute结尾但使用时可以省略 // 3. 需要添加[System.Serializable]以便序列化但PropertyAttribute本身已可序列化 public class MyCustomAttribute : PropertyAttribute { // 可以在这里定义一些配置参数 public string DisplayName { get; private set; } public float MaxValue { get; private set; } // 构造函数用于初始化这些参数 public MyCustomAttribute(string displayName “Default”, float maxValue 100f) { DisplayName displayName; MaxValue maxValue; } }这个MyCustomAttribute现在就是一个合法的“标签”了。你可以把它贴在任何支持序列化的字段上public class MyComponent : MonoBehaviour { [MyCustomAttribute(“生命值”, 500f)] public float health; // 使用时的简写省略“Attribute”后缀 [MyCustom(“攻击力”, 999f)] public float attackPower; }此时如果你运行游戏Inspector里这两个字段的显示不会有任何变化。因为Unity只知道这里有个MyCustom标签但并不知道该如何根据这个标签来绘制字段。这就是PropertyDrawer出场的时候了。注意PropertyAttribute的构造函数参数只能是基本常量类型如int,float,string,bool或者System.Type。不能传递对象实例、数组等复杂数据。这是因为Attribute的信息是在编译时就被确定的。2.2 PropertyDrawerInspector的画笔PropertyDrawer继承自UnityEditor.PropertyDrawer注意命名空间是UnityEditor这意味着它只在编辑器下生效。它的核心使命是给定一个序列化属性SerializedProperty和一个区域Rect在这个区域里画出你想要的UI。Unity编辑器内部有一个“绘制器查找表”。当你打开一个包含被标记字段的Inspector时Unity会找到这个字段对应的SerializedProperty。检查该字段上是否有PropertyAttribute。如果有就去查找注册的PropertyDrawer中有没有哪个能处理这个特定的Attribute类型。找到后就将绘制工作委托给这个PropertyDrawer的OnGUI方法。关联PropertyDrawer和PropertyAttribute的关键是给PropertyDrawer类添加[CustomPropertyDrawer(typeof(YourAttribute))]这个Attribute。using UnityEditor; using UnityEngine; // 关键使用CustomPropertyDrawer特性关联到我们自定义的Attribute [CustomPropertyDrawer(typeof(MyCustomAttribute))] public class MyCustomDrawer : PropertyDrawer { // 核心方法如何绘制属性 public override void OnGUI(Rect position, SerializedProperty property, GUIContent label) { // 1. 获取我们定义的Attribute实例 MyCustomAttribute myAttr attribute as MyCustomAttribute; // 2. 修改标签文本 label.text myAttr.DisplayName; // 3. 根据字段类型进行绘制 if (property.propertyType SerializedPropertyType.Float) { // 使用Slider绘制最大值来自Attribute参数 property.floatValue EditorGUI.Slider(position, label, property.floatValue, 0f, myAttr.MaxValue); } else { // 如果不支持的类型回退到默认绘制并给出警告 EditorGUI.LabelField(position, label.text, “不支持的字段类型”); // 或者调用基类方法绘制默认UI // base.OnGUI(position, property, label); } } // 可选返回此属性绘制所需的高度 public override float GetPropertyHeight(SerializedProperty property, GUIContent label) { // 通常返回一行的高度如果需要多行UI则计算总高度 return EditorGUIUtility.singleLineHeight; } }现在你再去看Inspectorhealth和attackPower字段就会显示为带有自定义标签名和最大值的滑动条了。整个协作流程可以概括为Attribute定义“要做什么”WhatDrawer定义“怎么做”How。2.3 SerializedProperty编辑器与数据的桥梁在PropertyDrawer的OnGUI方法中第三个参数SerializedProperty property是核心操作对象。它不是字段的运行时值而是Unity序列化系统对那个字段的一个“引用”或“代理”。通过它你可以安全地读取和修改序列化字段的值并且能自动处理撤销Undo、预制件覆盖Prefab Override等编辑器功能。你需要根据property.propertyType来判断字段的底层类型然后使用对应的方法property.intValue,property.floatValue,property.stringValue用于基本类型。property.objectReferenceValue用于引用类型如GameObject,ScriptableObject。property.vector3Value用于Vector3等Unity结构体。property.enumValueIndex用于枚举获取的是索引通常需要转换。对于数组或列表使用property.arraySize和property.GetArrayElementAtIndex(index)。一个至关重要的细节在OnGUI中你应该使用EditorGUI或EditorGUILayout提供的方法来绘制UI并直接赋值给property.XXXValue。例如property.floatValue EditorGUI.Slider(...)。这样赋值Unity的序列化系统才能捕获到变化。切忌先从一个临时变量读取绘制完再赋值这可能会丢失中间帧的编辑状态。3. 实战进阶从简单到复杂的绘制器实现理解了基本原理后我们通过几个由浅入深的例子来看看如何应对实际开发中的各种需求。我会在每个例子中穿插我踩过的坑和总结的技巧。3.1 案例一为枚举添加颜色标签与图标Unity默认的枚举下拉菜单是黑白的当枚举项很多且代表不同状态时比如物品品质普通、稀有、史诗、传说辨识度很低。我们想为每个枚举值附加一个颜色和图标。首先定义Attribute用于存储颜色和图标路径或直接引用public class EnumStyleAttribute : PropertyAttribute { public readonly string[] Colors; public readonly string[] IconNames; // 假设图标在特定Resources路径下 public EnumStyleAttribute(string[] colors, string[] iconNames) { Colors colors; IconNames iconNames; } }在组件上使用public class Item : MonoBehaviour { [EnumStyle(new string[] { “#808080”, “#1E90FF”, “#9370DB”, “#FFD700” }, new string[] { “icon_common”, “icon_rare”, “icon_epic”, “icon_legend” })] public ItemRarity rarity; } public enum ItemRarity { Common, Rare, Epic, Legendary }接下来是复杂的Drawer实现。我们不能简单地画一个下拉菜单而是要自己绘制一个带颜色的按钮式选择器。[CustomPropertyDrawer(typeof(EnumStyleAttribute))] public class EnumStyleDrawer : PropertyDrawer { public override void OnGUI(Rect position, SerializedProperty property, GUIContent label) { EnumStyleAttribute styleAttr attribute as EnumStyleAttribute; if (property.propertyType ! SerializedPropertyType.Enum) { EditorGUI.HelpBox(position, “EnumStyleAttribute 只能用于枚举类型”, MessageType.Error); return; } // 获取当前枚举类型和值 Type enumType fieldInfo.FieldType; string[] enumNames property.enumDisplayNames; int currentIndex property.enumValueIndex; // 计算每个按钮的宽度 float buttonWidth position.width / enumNames.Length; Rect buttonRect new Rect(position.x, position.y, buttonWidth, position.height); EditorGUI.LabelField(new Rect(position.x, position.y, EditorGUIUtility.labelWidth, position.height), label); // 绘制标签后的区域 Rect buttonsRect new Rect(position.x EditorGUIUtility.labelWidth, position.y, position.width - EditorGUIUtility.labelWidth, position.height); buttonWidth buttonsRect.width / enumNames.Length; buttonRect new Rect(buttonsRect.x, buttonsRect.y, buttonWidth, buttonsRect.height); // 为每个枚举值绘制一个带颜色的按钮 for (int i 0; i enumNames.Length; i) { // 解析颜色 Color originalColor GUI.color; if (ColorUtility.TryParseHtmlString(styleAttr.Colors[i], out Color btnColor)) { GUI.color btnColor; } // 设置按钮样式当前选中的高亮 GUIStyle buttonStyle new GUIStyle(EditorStyles.miniButtonMid); if (i currentIndex) { buttonStyle.fontStyle FontStyle.Bold; buttonStyle.normal.textColor Color.white; } // 绘制按钮 if (GUI.Button(buttonRect, enumNames[i], buttonStyle)) { property.enumValueIndex i; property.serializedObject.ApplyModifiedProperties(); } // 这里可以添加加载并绘制图标的逻辑略复杂需缓存Texture2D // ... GUI.color originalColor; buttonRect.x buttonWidth; } } public override float GetPropertyHeight(SerializedProperty property, GUIContent label) { // 只需要一行高度 return EditorGUIUtility.singleLineHeight; } }实操心得性能注意在OnGUI中频繁加载资源如Resources.Load图标是性能杀手。正确的做法是在Drawer的静态构造函数或初始化方法中加载并缓存这些资源或者使用EditorGUIUtility.Load配合AssetDatabase。布局计算手动计算Rect是精细控制UI布局的基础。EditorGUIUtility.labelWidth是Unity为字段标签预留的宽度使用它能让你的自定义绘制器与内置字段对齐看起来更协调。撤销支持我们的代码在按钮点击时直接修改了property.enumValueIndex并调用了ApplyModifiedProperties()。但更规范的做法是使用EditorGUI.BeginChangeCheck()和EditorGUI.EndChangeCheck()包裹赋值逻辑这样能获得更好的撤销/重做支持。3.2 案例二创建可折叠的复杂结构体绘制器默认情况下自定义结构体struct在Inspector里会展开所有字段占用大量空间。我们希望为某些复杂的结构体如AttackModifier包含伤害类型、倍率、持续时间等提供一个可折叠、且内部布局更紧凑的绘制方式。首先定义结构体和Attribute[System.Serializable] public struct AttackModifier { public DamageType damageType; public float multiplier; public float duration; public bool isPercentage; } public enum DamageType { Fire, Ice, Lightning, Physical } // 这个Attribute用于标记希望用自定义折叠方式绘制的结构体字段 public class FoldoutStructAttribute : PropertyAttribute { public string DisplayName { get; private set; } public FoldoutStructAttribute(string displayName null) { DisplayName displayName; } }Drawer的实现需要处理折叠状态和递归绘制子属性[CustomPropertyDrawer(typeof(FoldoutStructAttribute))] public class FoldoutStructDrawer : PropertyDrawer { // 使用字典来保存每个属性实例的折叠状态Key由对象实例ID和属性路径生成确保唯一性 private static Dictionarystring, bool s_foldoutStates new Dictionarystring, bool(); public override void OnGUI(Rect position, SerializedProperty property, GUIContent label) { FoldoutStructAttribute attr attribute as FoldoutStructAttribute; string displayName string.IsNullOrEmpty(attr.DisplayName) ? label.text : attr.DisplayName; // 生成一个唯一Key来存储折叠状态 string key $“{property.serializedObject.targetObject.GetInstanceID()}.{property.propertyPath}”; if (!s_foldoutStates.ContainsKey(key)) { s_foldoutStates[key] false; // 默认折叠 } // 1. 绘制折叠标题栏 Rect foldoutRect new Rect(position.x, position.y, position.width, EditorGUIUtility.singleLineHeight); s_foldoutStates[key] EditorGUI.Foldout(foldoutRect, s_foldoutStates[key], displayName, true); if (!s_foldoutStates[key]) { // 如果折叠只显示标题高度就是一行 return; } // 2. 展开后绘制结构体内部的所有子属性 EditorGUI.indentLevel; float lineHeight EditorGUIUtility.singleLineHeight; float verticalSpacing EditorGUIUtility.standardVerticalSpacing; float currentY position.y lineHeight verticalSpacing; // 遍历结构体的所有子属性 SerializedProperty child property.Copy(); SerializedProperty end property.GetEndProperty(); bool enterChildren true; while (child.NextVisible(enterChildren) !SerializedProperty.EqualContents(child, end)) { enterChildren false; float childHeight EditorGUI.GetPropertyHeight(child, true); Rect childRect new Rect(position.x, currentY, position.width, childHeight); EditorGUI.PropertyField(childRect, child, true); currentY childHeight verticalSpacing; } EditorGUI.indentLevel--; } public override float GetPropertyHeight(SerializedProperty property, GUIContent label) { FoldoutStructAttribute attr attribute as FoldoutStructAttribute; string key $“{property.serializedObject.targetObject.GetInstanceID()}.{property.propertyPath}”; if (!s_foldoutStates.ContainsKey(key) || !s_foldoutStates[key]) { // 折叠状态高度为一行 return EditorGUIUtility.singleLineHeight; } // 展开状态计算所有子属性的总高度 float totalHeight EditorGUIUtility.singleLineHeight EditorGUIUtility.standardVerticalSpacing; SerializedProperty child property.Copy(); SerializedProperty end property.GetEndProperty(); bool enterChildren true; while (child.NextVisible(enterChildren) !SerializedProperty.EqualContents(child, end)) { enterChildren false; totalHeight EditorGUI.GetPropertyHeight(child, true) EditorGUIUtility.standardVerticalSpacing; } // 减去最后一个多余的间距 totalHeight - EditorGUIUtility.standardVerticalSpacing; return totalHeight; } }踩坑记录与技巧折叠状态管理折叠状态bool不能直接作为Drawer的成员变量因为同一个Drawer实例可能用于绘制场景中多个对象的同一个字段。必须使用一个以属性路径和目标对象实例ID组合成的唯一键来存储在静态字典中。property.propertyPath给出了从根对象到该属性的完整路径结合对象ID可以精确区分每一个被绘制的属性实例。遍历子属性SerializedProperty.Copy()和NextVisible()是遍历所有子属性的标准模式。GetEndProperty()获取一个“结束标记”用于判断遍历何时停止。enterChildren参数控制是否进入数组或嵌套结构的内部。高度计算GetPropertyHeight必须与OnGUI中的绘制逻辑严格对应。在展开状态下需要递归计算所有子属性的高度。使用EditorGUI.GetPropertyHeight(child, true)可以自动获得包含子项的高度这是最可靠的方法。缩进管理在绘制子属性前增加EditorGUI.indentLevel绘制完后恢复可以让子属性正确缩进符合Unity的视觉习惯。3.3 案例三实现一个关联资源与预览的Asset引用绘制器Unity默认的ObjectField可以拖入资源但有时我们想增强它。例如一个“音效”字段拖入AudioClip后希望在Inspector里直接显示一个播放/停止按钮或者一个“纹理”字段旁边能显示一个小预览图。这个例子我们实现一个带预览图的纹理引用绘制器。public class PreviewTextureAttribute : PropertyAttribute { public float PreviewHeight { get; private set; } public PreviewTextureAttribute(float previewHeight 64f) { PreviewHeight previewHeight; } } [CustomPropertyDrawer(typeof(PreviewTextureAttribute))] public class PreviewTextureDrawer : PropertyDrawer { public override void OnGUI(Rect position, SerializedProperty property, GUIContent label) { if (property.propertyType ! SerializedPropertyType.ObjectReference) { EditorGUI.HelpBox(position, “PreviewTextureAttribute 只能用于Object引用类型”, MessageType.Error); return; } PreviewTextureAttribute attr attribute as PreviewTextureAttribute; float lineHeight EditorGUIUtility.singleLineHeight; float spacing EditorGUIUtility.standardVerticalSpacing; // 第一行标签和Object字段 Rect objectFieldRect new Rect(position.x, position.y, position.width, lineHeight); EditorGUI.ObjectField(objectFieldRect, property, typeof(Texture), label); // 如果当前有引用并且是Texture类型则绘制预览 Texture texture property.objectReferenceValue as Texture; if (texture ! null) { float previewY position.y lineHeight spacing; Rect previewRect new Rect(position.x, previewY, position.width, attr.PreviewHeight); // 绘制一个背景框 EditorGUI.DrawRect(previewRect, new Color(0.15f, 0.15f, 0.15f, 0.9f)); // 计算保持比例的预览区域 float aspectRatio (float)texture.width / texture.height; float previewWidth attr.PreviewHeight * aspectRatio; if (previewWidth position.width) { previewWidth position.width; attr.PreviewHeight previewWidth / aspectRatio; } Rect imageRect new Rect( position.x (position.width - previewWidth) * 0.5f, previewY (attr.PreviewHeight - attr.PreviewHeight) * 0.5f, // 垂直居中 previewWidth, attr.PreviewHeight ); // 绘制纹理 GUI.DrawTexture(imageRect, texture, ScaleMode.ScaleToFit); // 可选在预览图上方或下方显示纹理信息 Rect infoRect new Rect(position.x, previewY attr.PreviewHeight 2f, position.width, lineHeight); EditorGUI.LabelField(infoRect, $“{texture.width}x{texture.height} | {GetTextureFormatInfo(texture)}”, EditorStyles.centeredGreyMiniLabel); } } public override float GetPropertyHeight(SerializedProperty property, GUIContent label) { PreviewTextureAttribute attr attribute as PreviewTextureAttribute; float baseHeight EditorGUIUtility.singleLineHeight EditorGUIUtility.standardVerticalSpacing; if (property.objectReferenceValue as Texture ! null) { // 基础高度 预览图高度 信息标签高度 间距 return baseHeight attr.PreviewHeight EditorGUIUtility.singleLineHeight EditorGUIUtility.standardVerticalSpacing; } return baseHeight - EditorGUIUtility.standardVerticalSpacing; // 没有预览时只有一行 } private string GetTextureFormatInfo(Texture texture) { // 注意Texture.format是运行时API在编辑器下可能无法直接获取。 // 更可靠的方式是通过AssetDatabase和TextureImporter来获取信息。 // 这里简化处理实际使用时需要更复杂的逻辑。 return “RGB24”; // 示例 } }注意事项编辑器与运行时API在PropertyDrawer中你处于编辑器环境下可以自由使用EditorGUI、AssetDatabase等UnityEditor命名空间下的类。但要注意像Texture.format这样的属性在未加载的纹理上可能无法访问。对于复杂的资源信息获取可能需要通过AssetImporter如TextureImporter来查询。性能与重绘在OnGUI中绘制纹理预览是相对昂贵的操作尤其是预览图较大时。要确保GetPropertyHeight计算准确避免不必要的布局变化导致频繁重绘。对于非常复杂的预览如模型预览可以考虑使用EditorGUI.DrawPreviewTexture或更底层的Handles/GL绘图但这需要更深入的知识。泛用性这个Drawer目前只检查Texture。你可以修改ObjectField的接受类型和检查逻辑使其适用于AudioClip显示波形图、Material显示小球预览等多种资源原理是相通的。4. 高级技巧与性能优化当你开始大规模使用自定义绘制器时一些高级技巧和性能考量就变得至关重要。4.1 绘制器缓存与序列化数据管理PropertyDrawer的实例由Unity编辑器管理其生命周期并不完全由你控制。因此切忌在Drawer中存储与特定属性实例相关的状态比如输入框的临时字符串、滚动位置等。这些状态应该存储在序列化系统能够管理的地方。正确做法使用SerializedProperty本身来存储状态或者使用SerializedObject的FindProperty找到相关的“隐藏”属性。例如如果你想为一个字符串字段添加一个“编辑”按钮点击后展开一个大文本框这个“是否展开”的状态应该存储在该组件脚本的另一个bool序列化字段中并通过property.serializedObject.FindProperty(“myFoldoutState”)来获取和修改。对于需要复杂计算的数据如预览图的渲染结果可以考虑使用静态字典配合唯一键进行缓存但要注意及时清理无效的缓存项防止内存泄漏。键的生成可以结合property.serializedObject.targetObject.GetInstanceID()和property.propertyPath。4.2 处理数组与列表中的自定义绘制当你把自定义Attribute应用在数组或ListT的元素上时绘制器需要能正确处理。好消息是Unity会自动为数组中的每个元素调用对应的Drawer。但这里有个关键点property参数代表的是数组中的那个元素属性。在Drawer的OnGUI里property就是序列化数组中当前索引处的元素。你可以像操作单个字段一样操作它。GetPropertyHeight也同样被用于计算每个元素的高度。这使得为数组内的复杂结构创建美观的UI成为可能比如一个ListAttackModifier每个元素都显示为可折叠的卡片。一个常见需求自定义数组标题行。你可能想在整个数组上方添加一个自定义的按钮。这需要通过一个自定义的PropertyDrawer来绘制整个数组property.propertyType SerializedPropertyType.Generic且property.isArray为true但这属于更高级的CustomEditor范畴通常结合ReorderableList来实现已经超出了基础PropertyDrawer的范围。对于数组内元素的自定义PropertyDrawer完全胜任对于整个列表容器的自定义则需要考虑Editor脚本。4.3 与CustomEditor的协作与区分PropertyDrawer和CustomEditor为整个MonoBehaviour或ScriptableObject自定义Inspector都是扩展编辑器UI的工具但分工不同PropertyDrawer字段级。它只关心某一个特定的字段如何绘制。职责单一可复用性极高。一旦定义好任何使用了该Attribute的字段无论在哪个脚本里都会自动应用这个绘制方式。CustomEditor组件/资源级。它控制整个Inspector的布局。你可以在OnInspectorGUI中完全重排所有字段添加按钮、绘制曲线、创建复杂的标签页系统等。CustomEditor功能更强大但它是针对特定组件类型的复用性不如PropertyDrawer。最佳实践优先使用PropertyDrawer。只有当需要对整个Inspector进行大刀阔斧的改造或者需要协调多个字段之间的联动UI时才使用CustomEditor。在CustomEditor的OnInspectorGUI中你仍然可以调用EditorGUILayout.PropertyField(serializedObject.FindProperty(“myField”), true)来绘制字段而这个字段如果带有自定义的PropertyDrawer它的自定义绘制效果依然会显示出来两者可以和谐共存。5. 调试、排查与常见问题实录即使理解了所有原理在实际编写复杂Drawer时你依然会遇到各种诡异的问题。下面是我在项目中积累的一些典型问题及其解决方法。5.1 绘制器不生效检查清单脚本编译确保你的Drawer脚本放在Editor文件夹下或任意以Editor命名的文件夹中。只有放在Editor文件夹下的脚本才会在Unity编辑器中被编译运行时不会包含。这是最常见的错误。Attribute与Drawer关联检查[CustomPropertyDrawer(typeof(YourAttribute))]中的typeof参数是否完全匹配你的Attribute类名包括命名空间。字段类型匹配在Drawer的OnGUI开头检查property.propertyType是否是你期望的类型。一个为float设计的Drawer被用在int字段上就会出错。可以使用EditorGUI.HelpBox显示友好的错误信息。序列化支持确保你应用Attribute的字段是可序列化的public或带有[SerializeField]的private/protected字段。非序列化字段不会出现在Inspector中Drawer自然无效。编辑器刷新有时修改了Drawer代码后Inspector没有立即更新。尝试点击一下Inspector窗口的标题栏或者在Project窗口中点击任意一个脚本强制编辑器刷新所有自定义绘制器。5.2 布局错乱与高度计算陷阱GetPropertyHeight返回的高度必须与OnGUI中实际绘制的区域高度严格一致。如果高度计算偏小部分UI会被裁剪如果偏大会出现难看的空白区域并可能影响后续元素的布局。调试技巧在开发阶段可以临时在GetPropertyHeight中返回一个固定值比如100然后在OnGUI中用GUI.Box或EditorGUI.DrawRect为你的绘制区域画上不同颜色的背景直观地看到Unity为你分配的区域和你实际使用的区域是否匹配。另一个常见问题是未考虑间距。EditorGUIUtility.singleLineHeight是标准行高EditorGUIUtility.standardVerticalSpacing是标准垂直间距。在计算多行布局的总高度时别忘了在行与行之间加上间距但最后一行之后通常不加。5.3 撤销Undo操作失效如果你在Drawer中直接修改了property.XXXValueUnity的序列化系统通常会为你自动处理撤销。但是如果你在修改前后进行了复杂的逻辑判断或者修改了多个关联属性为了确保撤销操作的正确性应该使用标准模式public override void OnGUI(Rect position, SerializedProperty property, GUIContent label) { EditorGUI.BeginChangeCheck(); // 开始变更检查 // ... 你的绘制逻辑最终会修改property的值 ... float newValue EditorGUI.Slider(position, label, property.floatValue, 0, 10); if (EditorGUI.EndChangeCheck()) // 如果检测到变更 { property.floatValue newValue; // 赋值 property.serializedObject.ApplyModifiedProperties(); // 应用修改 } // 如果还有修改其他关联属性也放在EndChangeCheck块内 }EditorGUI.BeginChangeCheck()和EditorGUI.EndChangeCheck()会记录UI操作确保任何修改都能被正确地纳入一次撤销操作中。5.4 处理多对象编辑Multi-Object Editing当在场景中同时选中多个具有相同脚本的GameObject进行编辑时Inspector会进入多对象编辑模式。你的Drawer也需要能正确处理这种情况。值不一致显示当选中的多个对象在该字段上的值不同时property会显示一个“混合值”。EditorGUI控件如Slider、TextField大多能自动处理显示为空白或特殊标识。你在绘制时应避免在这种情况下显示一个确定的值。修改操作当你通过UI修改了字段这个修改会应用到所有选中的对象上。这是由property.serializedObject.ApplyModifiedProperties()自动完成的你一般不需要额外处理。自定义控件的注意事项如果你自己绘制了一个非标准的控件比如一套按钮在修改值之前最好检查property.hasMultipleDifferentValues。如果为true你可能需要设计特殊的交互比如点击按钮后是清除混合状态设置为统一值还是弹出一个对话框让用户选择。5.5 性能问题分析与优化复杂的Drawer尤其是那些包含纹理预览、实时计算或大量布局计算的可能会拖慢Inspector的响应速度。避免在OnGUI中执行昂贵操作如数据库查询、复杂的物理计算、频繁的Resources.Load或AssetDatabase.LoadAssetAtPath。这些操作的结果应该被缓存。减少不必要的重绘OnGUI每帧都可能被调用多次。确保你的绘制逻辑是轻量级的。对于基于时间的动画或预览考虑使用EditorApplication.update委托来驱动并只在数据变化时请求重绘EditorUtility.SetDirty。优化GetPropertyHeight这个方法的调用频率可能比OnGUI还高。确保它的计算尽可能快避免在这里进行复杂的遍历或计算。如果高度是固定的或依赖于一个简单属性直接返回缓存的值。使用GUILayout的权衡我们的例子大多使用基于Rect的EditorGUI因为布局精确。EditorGUILayout虽然方便但它在幕后也需要计算布局对于复杂或动态高度的UI有时反而更难控制性能。在自定义Drawer中我通常更推荐使用EditorGUI进行显式布局。最后分享一个我个人的习惯为每一个复杂的自定义Drawer创建一个专门的测试脚本和测试场景。在这个测试脚本中暴露各种边界情况空值、极值、数组、嵌套的字段然后观察Drawer的行为。这比在真实项目中调试要高效得多也能确保你的绘制器足够健壮。自定义属性绘制器是Unity编辑器扩展的基石花时间掌握它你打造的工具和工作流将产生质的飞跃。
