@IntDef 替代 enum：Android 官方推荐的轻量常量方案

用 int 常量的零对象开销换掉 enum 的贵——并在编译期保留一层类型安全检查。本文梳理 IntDef 的核心价值、Java/Kotlin 双版本用法、一个可运行 Demo以及几个容易踩的坑。本篇为独立 Android 开发 Tips与「十年车机性能优化系列」并列可单独阅读。一、为什么要在 Android 上慎用 enum在 Android 里每个enum常量都是一个对象实例它不仅占堆内存还会在 DEX 里生成额外的类结构、values()/valueOf()等方法直接推高包体积。举个例子一个只有 3 个值的enumpublic enum WeekDay { SUNDAY, MONDAY, TUESDAY }编译后等价于一个继承了java.lang.Enum的类附带静态初始化块、数组和若干方法。在服务器/桌面端这微不足道但在车载座舱、低端机这种内存和存储都紧张的场景大量使用 enum 会积少成多。也正因如此Android 官方的 API 设计指南明确要求在平台 API 中应优先使用IntDef而非enum。一句话enum提供强类型但贵IntDef几乎免费只牺牲一点类型强度。二、IntDef 是什么 核心优势IntDef来自androidx.annotation它不改变底层类型——变量本质还是int基本类型只是用注解把允许取哪些值标注出来让 Android Studio / Lint 在编译期给你标黄警告。特性IntDefstatic final intenum内存占用小本质是int常量大每个常量都是对象有额外内存开销DEX 文件大小小仅增加常量定义大会生成Enum相关的方法和对象类型安全编译时 IDE 警告非强约束强类型编译时直接报错完全安全代码可读性中等需查看注解定义高枚举自带清晰的命名空间和语义功能扩展弱仅能表示整数值极强可实现接口、包含方法、定义属性等三、Java 版完整用法三步1. 定义常量 创建注解import androidx.annotation.IntDef; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; public class WeekDay { // 1. 定义常量编译期常量 public static final int SUNDAY 0; public static final int MONDAY 1; public static final int TUESDAY 2; // 2. 用 IntDef 把常量集合起来并声明为 SOURCE 保留 IntDef({SUNDAY, MONDAY, TUESDAY}) Retention(RetentionPolicy.SOURCE) // 仅源码期保留不进字节码 public interface WeekDays { } }2. 用注解限制字段 / 参数 / 返回值public class Demo { // 限制字段 WeekDays private int today WeekDay.SUNDAY; // 限制方法参数 public void setToday(WeekDays int day) { this.today day; } // 限制返回值 WeekDays public int getToday() { return today; } }这样当你传入WeekDay.WEDNESDAY未定义常量或随便写一个数字setToday(99)Android Studio 会标黄警告实现编译期类型安全检查。定义 static final int 常量用 IntDef 包成注解标注到 参数/字段/返回值IDE/Lint 编译期标黄警告四、Kotlin 版完整用法Kotlin 里常量要用const val编译期常量否则无法写进IntDef的 value。import androidx.annotation.IntDef import androidx.annotation.Retention import androidx.annotation.RetentionPolicy object WeekDay { const val SUNDAY 0 const val MONDAY 1 const val TUESDAY 2 } Retention(RetentionPolicy.SOURCE) IntDef(WeekDay.SUNDAY, WeekDay.MONDAY, WeekDay.TUESDAY) annotation class WeekDays class Demo { WeekDays private var today: Int WeekDay.SUNDAY fun setToday(WeekDays day: Int) { this.today day } WeekDays fun getToday(): Int today }Kotlin 也有自己的enum class用法和 Java enum 一样贵。若只是为了限定取值集合Kotlin IntDef同样适用。五、进阶flag true 支持位运算当常量需要组合使用如FLAG_READ | FLAG_WRITE开启flag trueIntDef(flag true, value {FLAG_READ, FLAG_WRITE, FLAG_EXECUTE}) Retention(RetentionPolicy.SOURCE) public interface FlagMode {} // 使用 FlagMode private int mode FLAG_READ | FLAG_WRITE; public boolean hasFlag(FlagMode int mode, int flag) { return (mode flag) flag; // 用位与判断是否包含某标志 }开启flag true后Lint 允许这些位任意组合的值通过只要每一位都来自定义集合即可。六、完整可运行 Demo下面是一份纯 Java、可直接javac运行的 Demo。为保证脱离 Android 也能跑我们把IntDef在本地定义了一个同形状注解生产环境直接换成androidx.annotation.IntDef用法完全一致。import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; import java.lang.annotation.ElementType; // —— 本地版 IntDef形状与 androidx.annotation.IntDef 一致仅用于无 Android 依赖演示—— Retention(RetentionPolicy.SOURCE) Target({ElementType.FIELD, ElementType.METHOD, ElementType.PARAMETER}) interface IntDef { int[] value() default {}; boolean flag() default false; } public class IntDefDemo { // 1. 常量 public static final int SUNDAY 0; public static final int MONDAY 1; public static final int TUESDAY 2; // 2. 注解 IntDef({SUNDAY, MONDAY, TUESDAY}) Retention(RetentionPolicy.SOURCE) interface WeekDays {} // 3. 使用 WeekDays private int today SUNDAY; public void setToday(WeekDays int day) { this.today day; } WeekDays public int getToday() { return today; } public static void main(String[] args) { IntDefDemo d new IntDefDemo(); d.setToday(IntDefDemo.MONDAY); System.out.println(今天是 d.getToday()); // 输出 1 // 下面这行若取消注释Android Studio / Lint 会标黄警告编译仍能通过 // d.setToday(99); // ⚠ 不在 {0,1,2} 集合内 } }编译运行javac IntDefDemo.java java IntDefDemo # 输出今天是1在真实 Android 项目中把IntDefDemo里的本地IntDef删掉改为import androidx.annotation.IntDef;即可——其余代码一行都不用改。七、踩坑注意SOURCE 保留运行时拿不到Retention(SOURCE)意味着注解在编译后就被丢弃不能靠反射读取它做运行时校验。这既是省开销的优点也是无法运行时兜底的限制。IDE 警告 ≠ 编译报错IntDef是 Lint/IDE 的软约束编译能通过。如果你的 CI 不跑lint错误的int值照样进包。要强制拦截需在 CI 跑./gradlew lint或写自定义 Lint 规则。Kotlin 必须用const val写在companion object里的普通val不是编译期常量塞不进IntDef({...})会直接编译报错。只有顶层的const val或object内的const val才行。漏写常量 漏检IntDef的 value 数组里若漏了某个常量那个常量就不在受检集合内调用方传它不会报警告。增删常量时务必同步更新 value。flag 组合仍可能越界flag true只保证每一位都来自集合不保证组合后的值合法。若某些组合业务上不允许需要自己在代码里校验。别为了像 enum 而过度设计IntDef只能表达整数值无法携带数据或行为。当常量需要关联颜色、文案或要实现抽象方法时enum才是更合适的选择——性能不是唯一维度。小结IntDef是 Android 上用最小代价换类型安全的标准做法底层是int、零对象开销、不增大 DEX还能在写代码时拦下非法取值。绝大多数常量集合场景优先用它只有当常量需要携带数据或有行为逻辑时才值得为enum的贵买单。