代码检查：分组路径未定义

此检查会标记 Odin Inspector 的布局和分组特性，其引用的分组路径未在类中定义。

运作方式

使用诸如 A/B/C 这样的分组路径时，Odin 要求路径中每个前缀都必须被定义。此分析器会按顺序验证路径中的每一部分（首先是 A ，然后是 A/B ，最后是 A/B/C）。第一个缺失的前缀会触发警告。

高亮显示会直接放在字符串文字中缺失的子字符串上，而不是整个特性字符串上。这适用于 Odin 布局特性，例如：

BoxGroup
FoldoutGroup
HorizontalGroup
VerticalGroup
TabGroup
ToggleGroup
TitleGroup
HideIfGroup
ShowIfGroup

检查只有在分组实参为常量字符串文字且类被发现使用 Odin 布局特性时才会报告。

使用未定义的分组路径会导致 Unity Inspector 中的运行时错误。

示例

在此示例中， field1 被分配给分组路径 "General/Settings" ，但前缀 "General" 未被定义为分组。

                public class MyScript : MonoBehaviour
                {
                    // Reported: Group path 'General' is not defined
                    [BoxGroup("General/Settings")]
                    public int field1;
                }
            
   

                public class MyScript : MonoBehaviour
                {
                    // After fix: The root group "General" is defined first
                    [VerticalGroup("General")]
                    [BoxGroup("General/Settings")]
                    public int field1;
                }
            
   

2026年 5月 8日