Jetpack Compose自定义主题不生效问题求助

1. 核对Theme.kt的主题定义逻辑 #

确保ReaderTheme正确关联自定义配色方案，且未被动态配色覆盖。正确写法示例：

@Composable
fun ReaderTheme(
    darkTheme: Boolean = isSystemInDarkTheme(),
    dynamicColor: Boolean = false, // 先关闭动态配色测试
    content: @Composable () -> Unit
) {
    val colorScheme = if (darkTheme) {
        DarkColorScheme // 你的自定义深色配色
    } else {
        LightColorScheme // 你的自定义浅色配色
    }
    MaterialTheme(
        colorScheme = colorScheme,
        typography = Typography,
        content = content
    )
}

注意：Android 12+开启dynamicColor时，系统动态配色会优先覆盖自定义颜色，建议先关闭该参数验证。

2. 确认MainActivity的主题包裹范围 #

检查ReaderTheme是否包裹了所有Composable内容（包括导航组件），示例：

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            ReaderTheme {
                // 导航或根Composable放在这里
                NavHost(navController = navController, startDestination = "home") {
                    // 页面定义
                }
            }
        }
    }
}

无需在导航的每个页面单独调用主题，根节点包裹一次即可生效。

3. 检查自定义ColorScheme的正确性 #

确认配色方案是通过lightColorScheme/darkColorScheme正确构造的，避免拼写或颜色值错误：

private val LightColorScheme = lightColorScheme(
    background = Color(0xFFF0F4F8), // 自定义浅色背景
    surface = Color(0xFFFFFFFF),
    // 按需定义primary、secondary等其他颜色
)

private val DarkColorScheme = darkColorScheme(
    background = Color(0xFF1A1D23), // 自定义深色背景
    surface = Color(0xFF2D3138),
    // 按需定义其他颜色
)

4. 验证组件对主题颜色的引用 #

确保ListButton等组件直接从MaterialTheme.colorScheme获取颜色，而非硬编码：

@Composable
fun ListButton() {
    Button(
        onClick = {},
        colors = ButtonDefaults.buttonColors(
            containerColor = MaterialTheme.colorScheme.background
        )
    ) {
        Text("按钮")
    }
}

若组件内使用Color.White/Color.Black这类硬编码值，会直接覆盖主题颜色。

5. 清理IDE缓存并重建项目 #

IDE缓存可能导致修改不生效，执行以下操作：

• 点击File -> Invalidate Caches... -> Invalidate and Restart
• 执行Build -> Clean Project，再Build -> Rebuild Project

6. 验证系统主题同步 #

在设备系统设置中切换浅色/深色模式，回到应用观察颜色变化。若未同步，检查ReaderTheme的darkTheme参数是否正确传入isSystemInDarkTheme()。

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