为什么ViewPager2的offscreenPageLimit赋值常量报错需为默认值，直接写4却正常？

这个报错根本不是Kotlin编译器抛出的语法错误，是ViewPager2配套的Android Lint静态检查的误报，和你定义的常量数值是否正确完全无关。

• ViewPager2为offscreenPageLimit写的Lint校验逻辑设计得非常死板，静态扫描时只认两类合法赋值：
  • 直接写在赋值语句右侧的原始数字字面量：你直接写viewPager.offscreenPageLimit = 4时，Lint能直接读到传入值是合法的正整数，自然不会触发报错
  • 直接引用ViewPager2.OFFSCREEN_PAGE_LIMIT_DEFAULT这个组件自带的静态常量（值为-1，代表组件默认的自动离屏缓存策略）
• 这套校验逻辑不会跨引用链追踪常量的实际取值：哪怕你在companion object里定义的private const val NUM_PAGES = 4是完全合规的编译期常量，Lint在扫描到赋值语句右侧是一个变量引用节点时，根本不会跳转到常量定义位置去解析它的实际值，只会默认你传入了一个不在校验白名单里的未知值，最终弹出那句“必须为ViewPager2.OFFSCREEN_PAGE_LIMIT_DEFAULT之一”的提示。

完全不需要担心这个赋值会引发运行时崩溃：ViewPager2真正在代码运行时执行的赋值校验非常宽松，只要传入的值满足两个条件就能正常工作：

1. 等于OFFSCREEN_PAGE_LIMIT_DEFAULT（-1）
2. 或者是大于0的正整数

你的自定义常量值4完全符合运行时的校验规则，刚才的报错纯粹是静态检查的逻辑缺陷，对实际功能没有任何影响。

• 最省事的方案：直接在赋值位置写数字字面量即可，你自定义的NUM_PAGES常量可以继续保留给其他需要用到页面总数的场景（比如适配器初始化、页面偏移量计算等）
• 如果一定要用自定义常量完成赋值，可以在赋值代码行上方加一行注解跳过这个误报：

  @SuppressLint("WrongConstant")
  viewPager.offscreenPageLimit = NUM_PAGES
  

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