如何在IntelliJ IDEA中为MyEnum.values()标记@NonNull注解？

这确实是个挺让人纠结的细节问题——毕竟Enum.values()从语义和实际运行来看，绝对不会返回null（哪怕是空枚举，它也会返回长度为0的数组），但因为这个方法是编译器自动生成的，没有对应的源码文件，没法通过外部注解来标记@NonNull，导致IDE的空指针检查会误报，确实烦人。

下面分享几个比“每个枚举写自定义getValues()”更优的解决思路：

1. 利用IDE的全局配置强制标记为NonNull（最省心） #

如果你用的是IntelliJ IDEA，可以直接在IDE层面把Enum.values()标记为非空，一劳永逸：

• 打开 Settings > Editor > Inspections > Java > Probable bugs > Nullability issues
• 找到「Custom method signatures」选项，点击「Configure」
• 添加一个新的方法签名：java.lang.Enum.values()，然后在「Nullability」下拉框中选择「NotNull」
• 应用设置后，IDE就会默认认为所有枚举的values()方法返回非空，不会再出现不必要的空指针警告

这个方案完全不需要修改代码，适合团队统一IDE配置的场景。

2. 写一个通用的枚举工具类（无IDE依赖） #

如果不想依赖IDE配置，可以写一个全局的枚举工具类，封装values()调用并标记@NonNull：

import org.jetbrains.annotations.NotNull;
import java.util.Arrays;
import java.util.List;

public class EnumUtils {
    @NotNull
    public static <E extends Enum<E>> E[] values(@NotNull Class<E> enumClass) {
        E[] values = enumClass.getEnumConstants();
        // 这里其实不会为null，因为枚举类的getEnumConstants只会返回数组（空或非空）
        return values != null ? values : (E[]) new Enum[0];
    }

    // 额外提供List版本，更方便后续操作
    @NotNull
    public static <E extends Enum<E>> List<E> asList(@NotNull Class<E> enumClass) {
        return Arrays.asList(values(enumClass));
    }
}

使用的时候只需要静态导入，写法也很直观：

import static com.yourpackage.EnumUtils.values;

// 替代MyEnum.values()
MyEnum[] enumValues = values(MyEnum.class);

这个工具类只需要写一次，所有枚举都能复用，比每个枚举写自定义方法要简洁得多，而且方法名values和原生的保持一致，开发者一看就懂，几乎不需要额外文档。

3. 借助Lombok的@NonNull辅助（可选） #

如果你的项目已经在用Lombok，可以在调用Enum.values()的地方，用@NonNull注解来显式标记返回值非空：

import lombok.NonNull;

// 显式标记返回值非空
@NonNull MyEnum[] values = MyEnum.values();

不过这个方案需要在每个调用点都加注解，适合零散调用的场景，不如前两个方案高效。

最后补充一句：其实JDK本身的Enum.values()方法在语义上就是非空的，IDE的警告更多是因为缺乏注解提示，所以上面的方案都是从消除IDE警告的角度出发，本质上不会改变代码的运行逻辑。

内容的提问来源于stack exchange，提问作者Bill K