Android：RecyclerView的DividerItemDecoration深色模式下不显示的修复方法

默认初始化的DividerItemDecoration没有手动指定分隔线样式时，会自动读取当前应用主题下的android:listDivider属性作为分隔线的渲染样式。
绝大多数适配了深色模式的应用，尤其是使用Material3默认主题的项目，会在深色主题配置中将android:listDivider设置为透明值、或是与页面深色背景一致的颜色，这就导致了分隔线视觉上“消失”的问题。

方案1：手动为DividerItemDecoration指定自定义分隔线（推荐） #

这种方式不依赖全局主题的默认配置，适配灵活性更高：

• 在res/drawable目录下新建自定义分隔线资源，例如命名为recycler_divider.xml：

  <shape android:shape="rectangle" xmlns:android="http://schemas.android.com/apk/res/android">
      <size android:height="1dp" />
      <solid android:color="@color/recycler_divider" />
  </shape>
  

• 在values/colors.xml和values-night/colors.xml中分别配置普通模式、深色模式下适配的分隔线色值，避免直接使用硬编码颜色。
• 初始化分隔线装饰时，通过setDrawable()方法将自定义分隔线设置进去，替换掉默认读取主题的逻辑：

  val divider = DividerItemDecoration(this@MainActivity, LinearLayoutManager.VERTICAL)
  divider.setDrawable(ResourcesCompat.getDrawable(resources, R.drawable.recycler_divider, theme)!!)
  recyclerView.addItemDecoration(divider)
  

方案2：全局修正主题的listDivider配置 #

如果项目中有大量地方都在使用默认初始化的DividerItemDecoration，可以统一在主题配置中补充分隔线属性，不用逐处修改业务代码：

• 在普通模式的主题（values/themes.xml）和深色模式的主题（values-night/themes.xml）中，分别指定适配的android:listDivider值：

  <!-- 两个主题文件都加上这行配置，分别对应适配本模式的分隔线drawable -->
  <item name="android:listDivider">@drawable/recycler_divider</item>
  

不要直接在代码中硬编码分隔线颜色，必须通过color资源做深浅模式的色值适配，否则即使修复了当前不显示的问题，切换模式后还是会出现色彩对比度不足的问题。

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