NaughtyAttributes扩展开发：如何创建自己的自定义属性完整指南

2026-02-06 05:09:54作者：翟江哲Frasier

NaughtyAttributes是一个强大的Unity属性扩展库，它通过自定义属性标签为Inspector界面添加了丰富的交互功能。本文将为您详细介绍如何基于NaughtyAttributes框架创建自己的自定义属性，从基础概念到实际开发步骤，帮助您掌握Unity属性扩展的开发技巧。

为什么需要自定义属性？

在Unity开发中，Inspector是我们与组件交互的主要界面。然而，标准的Inspector功能有限，无法满足复杂项目的需求。通过自定义属性，您可以：

优化工作流程，减少重复配置
增强数据验证，防止错误输入
提供更好的用户体验，简化复杂操作
实现条件逻辑，按需展示相关参数

NaughtyAttributes架构解析

核心类结构

NaughtyAttributes采用清晰的架构设计，主要包含三个核心部分：

属性基类：

DrawerAttribute - 所有绘图属性的基类
SpecialCaseDrawerAttribute - 特殊绘图属性的基类
ValidatorAttribute - 验证属性的基类

编辑器绘制器：

PropertyDrawerBase - 属性绘制器的抽象基类
SpecialCasePropertyDrawerBase - 特殊属性绘制器的抽象基类

工具类：

PropertyUtility - 提供属性反射和条件检查功能

创建自定义属性的完整步骤

第一步：定义属性类

首先创建一个继承自相应基类的属性类：

public class MyCustomAttribute : DrawerAttribute
{
    public string DisplayName { get; private set; }
    
    public MyCustomAttribute(string displayName)
    {
        DisplayName = displayName;
    }
}

第二步：实现属性绘制器

创建对应的绘制器类，继承自PropertyDrawerBase：

[CustomPropertyDrawer(typeof(MyCustomAttribute))]
public class MyCustomPropertyDrawer : PropertyDrawerBase
{
    protected override void OnGUI_Internal(Rect rect, SerializedProperty property, GUIContent label)
    {
        // 自定义绘制逻辑
        EditorGUI.PropertyField(rect, property, label);
    }
    
    protected override float GetPropertyHeight_Internal(SerializedProperty property, GUIContent label)
    {
        return EditorGUI.GetPropertyHeight(property, includeChildren: true);
    }
}

第三步：使用自定义属性

在MonoBehaviour或ScriptableObject中使用您的新属性：

public class MyComponent : MonoBehaviour
{
    [MyCustom("自定义显示名称")]
    public int myValue;
}

实用示例：创建条件显示属性

让我们通过一个实际例子来演示如何创建一个条件显示属性。

属性定义

public class ShowIfEnumAttribute : DrawerAttribute
{
    public string ConditionName { get; private set; }
    public Enum ExpectedValue { get; private set; }
    
    public ShowIfEnumAttribute(string conditionName, Enum expectedValue)
    {
        ConditionName = conditionName;
        ExpectedValue = expectedValue;
    }
}

绘制器实现

[CustomPropertyDrawer(typeof(ShowIfEnumAttribute))]
public class ShowIfEnumPropertyDrawer : PropertyDrawerBase
{
    protected override void OnGUI_Internal(Rect rect, SerializedProperty property, GUIContent label)
    {
        var showIfAttribute = (ShowIfEnumAttribute)attribute;
        bool shouldShow = CheckCondition(property, showIfAttribute);
        
        if (shouldShow)
        {
            EditorGUI.PropertyField(rect, property, label, true);
        }
    }
    
    protected override float GetPropertyHeight_Internal(SerializedProperty property, GUIContent label)
    {
        return shouldShow ? EditorGUI.GetPropertyHeight(property, label, true) : 0;
    }
}

高级技巧与最佳实践

1. 利用PropertyUtility工具类

PropertyUtility类提供了丰富的反射功能，可以轻松获取字段信息、属性标签和调用回调方法。

2. 实现条件验证

private bool CheckCondition(SerializedProperty property, ShowIfEnumAttribute attribute)
{
    object target = PropertyUtility.GetTargetObjectWithProperty(property);
    FieldInfo conditionField = ReflectionUtility.GetField(target, attribute.ConditionName);
    
    if (conditionField != null)
    {
        Enum currentValue = (Enum)conditionField.GetValue(target);
        return currentValue.Equals(attribute.ExpectedValue);
    }
    
    return false;
}

3. 处理数组和列表

对于数组类型的属性，需要特殊处理索引和元素访问：

private static object GetValue_Imp(object source, string name, int index)
{
    IEnumerable enumerable = GetValue_Imp(source, name) as IEnumerable;
    if (enumerable == null) return null;
    
    IEnumerator enumerator = enumerable.GetEnumerator();
    for (int i = 0; i <= index; i++)
    {
        if (!enumerator.MoveNext()) return null;
    }
    
    return enumerator.Current;
}