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

此检查会标记 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日