代码检查:Odin 的组特性类型不正确
该检查可确保在使用 Odin Inspector 分组特性时,类成员的组定义保持一致。
运作方式
在 Odin Inspector 中,同一组必须具备一致的类型。 为同一路径定义不同类型的组特性(例如对同一路径混用 BoxGroup 和 HorizontalGroup )存在歧义,可能导致 Unity Inspector 中的布局行为不可预测。
分析器会收集类中的所有分组特性,并识别某个特定组路径(例如 "General/Settings" )关联了多种特性类型时的冲突。 如果成员使用的特性与该组路径已建立的特性类型不同,分析器会标记该特性名称,并建议使用预期的特性类型。
示例
在此示例中, field1 将 "MyGroup" 定义为 BoxGroup ,但 field2 错误地尝试在同一路径上使用 HorizontalGroup。 快速修复会将特性更改为与组的其他成员一致。
public class MyScript : MonoBehaviour
{
[BoxGroup("MyGroup")]
public int field1;
// Reported: Group "MyGroup" is already defined as BoxGroup
[HorizontalGroup("MyGroup")]
public int field2;
}
public class MyScript : MonoBehaviour
{
[BoxGroup("MyGroup")]
public int field1;
// After fix: Attribute corrected to match the group definition
[BoxGroup("MyGroup")]
public int field2;
}
2026年 5月 8日