Jetpack Compose深色模式始终不显示深色配色问题求助

核心排查与修复步骤 #

1. 统一使用Material3组件与依赖
   确保项目依赖的是Material3库，避免混合Material2和Material3：

   // Module级build.gradle
   implementation "androidx.compose.material3:material3:1.1.2" // 替换为最新稳定版
   

   同时检查所有Composable的导入：MaterialTheme、Scaffold、TopAppBar必须来自androidx.compose.material3，不能是androidx.compose.material（Material2包）。

2. 确认ColorScheme定义正确
   从主题生成器下载的LightColors和DarkColors必须是Material3的ColorScheme实例，要用lightColorScheme()/darkColorScheme()创建，而非Material2的lightColors()：

   // 正确示例
   private val LightColors = lightColorScheme(
       primary = Color(0xFF6750A4),
       background = Color(0xFFFFFBFE),
       // 其他色值...
   )
   
   private val DarkColors = darkColorScheme(
       primary = Color(0xFFD0BCFF),
       background = Color(0xFF1C1B1F),
       // 其他色值...
   )
   

   如果用了Material2的Colors类，和Material3的MaterialTheme不兼容，会导致颜色完全不生效。

3. 修正Scaffold与TopAppBar的参数
   Material3的Scaffold已废弃background参数，改用containerColor；同时TopAppBar要使用Material3版本并正确绑定主题颜色：

   @Composable
   private fun HomeContent() {
       Scaffold(
           containerColor = MaterialTheme.colorScheme.background,
           topBar = {
               TopAppBar(
                   title = { Text("Hello World!") },
                   colors = TopAppBarDefaults.topAppBarColors(
                       containerColor = MaterialTheme.colorScheme.primaryContainer,
                       titleContentColor = MaterialTheme.colorScheme.onPrimaryContainer
                   )
               )
           },
           content = { paddingValues ->
               Text(
                   "Hello World",
                   modifier = Modifier.padding(paddingValues)
               )
           }
       )
   }
   

4. 强制测试DarkColors
   暂时修改AppTheme强制使用DarkColors，验证色值是否真的生效：

   @Composable
   fun AppTheme(
     useDarkTheme: Boolean = isSystemInDarkTheme(),
     content: @Composable () -> Unit
   ) {
     val colors = DarkColors // 强制使用深色主题
     MaterialTheme(
       colorScheme = colors,
       content = content
     )
   }
   

   如果此时还是显示浅色，说明DarkColors的色值配置有误，重新核对主题生成器导出的色值。

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