Android开发中如何正确使用主题？主题切换失效如何解决

预览显示正常但真机/模拟器运行样式不生效、主题切换部分失效，核心是样式优先级冲突、调用时机错误、资源配置不匹配三类问题，按以下清单逐一排查即可：

• 首先排查通用问题：布局预览仅读取当前XML文件绑定的临时样式，运行时样式优先级从高到低为：单个View硬编码属性 > View单独设置的style/theme > 父布局设置的theme > Activity绑定的theme > Application绑定的theme。只要任意高优先级层级写了硬编码颜色、固定样式，就会覆盖全局主题配置，这是预览和运行效果不一致的最常见原因。

AppCompatDelegate.setDefaultNightMode(MODE_NIGHT_YES) 失效排查 #

• 调用时机错误：该方法必须在首帧View渲染前调用，如果在Activity已执行setContentView()后调用，必须立刻调用activity.recreate()重启当前页面才能生效，否则配置只会在下次App冷启动时应用。
• 资源配置不匹配：检查res目录下是否存在values-night资源目录，该目录下的主题文件名、色值文件名必须和values目录下的命名完全一致，否则切换夜间模式时会加载错位资源。
• 配置变更拦截：检查AndroidManifest.xml中对应Activity是否配置了android:configChanges="uiMode"，如果添加了该配置，必须重写Activity的onConfigurationChanged方法手动处理主题更新，否则系统不会重建页面应用夜间模式。
• 硬编码资源拦截：所有控件的颜色、背景不要直接写十六进制硬编码值，必须引用?attr/xxx主题属性，或是分values/values-night目录定义的色值资源，否则控件不会随主题切换改变样式。

setTheme(R.style.Theme_Dark) 显式设置主题失效排查 #

• 调用顺序错误：setTheme()必须放在super.onCreate(savedInstanceState)执行之后、setContentView()执行之前调用，放在View加载完成后调用不会触发任何样式更新。
• 主题继承错误：自定义的Dark主题必须和你基础主题保持相同的父类继承链，比如基础主题用的是Theme.MaterialComponents.DayNight系列，Dark主题也必须继承同系列的主题，不能跨系列继承系统原生主题，否则会出现部分控件属性不生效的问题。正确的主题定义示例：

<style name="Theme.Dark" parent="Theme.MaterialComponents.DayNight.NoActionBar">
    <item name="colorPrimary">@color/dark_brand_primary</item>
    <item name="colorSurface">@color/dark_bg</item>
    <item name="colorOnSurface">@color/dark_text_primary</item>
</style>

• 多层主题冲突：检查Application节点、Activity节点、布局根节点是否重复设置了其他theme属性，高优先级节点的theme会直接覆盖setTheme设置的全局主题。

注意：不要混用两种主题切换方案。setDefaultNightMode是基于资源限定符自动匹配对应目录下的同名资源实现切换，setTheme是手动替换整套主题资源，混用会导致资源id映射错乱，出现部分控件样式异常的问题。

快速定位方法 #

先清空所有布局XML中View的硬编码颜色、单独绑定的theme属性，在Manifest中确认Application和启动Activity绑定的是你的基础主题，写最小测试代码：在启动页的super.onCreate后立刻调用主题切换方法，再执行setContentView，确认基础切换逻辑正常后，再逐步添加自定义样式，定位是哪一层配置做了覆盖即可。

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