Android Material3 DayNight主题深色模式下不生效如何解决

这个问题是Material3主题适配深浅模式的高频坑，按以下步骤排查即可解决：

• 补齐深色模式对应的资源目录配置
  在项目res目录下新建values-night目录，在目录内创建和values目录下完全同名的themes.xml文件，该文件内的主题父元素同样声明为Theme.Material3.DayNight，深色模式下需要差异化调整的色值、样式参数全部写在这个文件里。

  踩坑提示：如果缺失values-night/themes.xml配置，系统触发深色模式切换时找不到匹配的Night资源，会直接回退到系统原生框架主题，直接表现就是Material圆角按钮变原生直角矩形、所有自定义Material样式失效。

• 检查Activity基类继承关系
  所有应用该主题的Activity必须继承AppCompatActivity，不能直接继承原生android.app.Activity。原生Activity不包含AppCompat和Material组件的主题适配逻辑，你之前测试固定Light/Dark主题能正常显示，只是因为主题样式刚好匹配当前系统版本的原生样式，一旦触发模式切换就会直接失效。
• 检查组件类引用是否正确
  布局文件里的Material组件要使用对应Material库中的类，比如按钮要用com.google.android.material.button.MaterialButton，不要直接用系统原生的Button控件，原生控件不支持Material主题的动态样式注入。
• 检查是否有硬编码的模式强制设置
  如果你没有自定义应用内深浅模式切换开关，就不要在Application或Activity的onCreate里调用AppCompatDelegate.setDefaultNightMode()手动指定模式，保持默认的MODE_NIGHT_FOLLOW_SYSTEM即可，手动指定固定模式会覆盖系统的自动切换逻辑。

配置完成后不用反复切系统设置验证，直接在Android Studio布局预览面板顶部点Day/Night切换按钮，选择Night模式如果能正常显示圆角Material按钮样式，就说明配置已经生效。

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