GD0302：泛型类型参数必须用“[MustBeVariant]”属性注解

规则 ID	GD0302
类别	用法
修复是破坏性的还是非破坏性的	破坏性的
默认启用	是

原因

当泛型类型参数期望 Variant 兼容类型时，为其指定泛型类型但指定的泛型类型未用 [MustBeVariant] 属性注解。

规则说明

当泛型类型参数使用 [MustBeVariant] 属性进行注解时，泛型类型必须是与 Variant 兼容的类型。当使用的类型也是泛型类型时，该泛型类型也必须使用 [MustBeVariant] 属性进行注解。例如，泛型 Godot.Collections.Array<T> 类型仅支持可以被转换为 Variant 类型的项，如果被正确注解，则可以指定泛型类型。

public void Method1<T>()
{
    // T is not valid here because it may not a Variant-compatible type.
    var invalidArray = new Godot.Collections.Array<T>();
}

public void Method2<[MustBeVariant] T>()
{
    // T is guaranteed to be a Variant-compatible type because it's annotated
    // with the [MustBeVariant] attribute, so it can be used here.
    var validArray = new Godot.Collections.Array<T>();
}

如何解决违规情况

要修复违反该规则的情况，请将 [MustBeVariant] 属性添加到泛型类型，该泛型类型被用作必须与 Variant 兼容的泛型类型参数。

何时抑制警告

不要抑制该规则的警告。包含用 [MustBeVariant] 属性注解的泛型类型参数的 API 通常有此要求，因为值将被传递给引擎，如果该类型无法被编组，则会导致运行时错误。