如何为Jetpack Compose强制关闭深色模式主题

核心原因 #

你之前的配置未生效，是因为Jetpack Compose的主题系统独立于传统AppCompat主题体系，默认会跟随系统深色模式开关动态切换配色，仅修改原生层配置无法覆盖Compose内部的主题逻辑。

1. 硬编码Compose主题为浅色模式 #

找到你项目中自定义的Compose主题代码（通常为Theme.kt文件），删除原有跟随系统判断深色模式的逻辑，固定使用浅色配色方案：
原来的动态逻辑示例：

@Composable
fun MyAppTheme(
    darkTheme: Boolean = isSystemInDarkTheme(),
    content: @Composable () -> Unit
) {
    val colorScheme = if (darkTheme) DarkColorScheme else LightColorScheme
    MaterialTheme(
        colorScheme = colorScheme,
        typography = Typography,
        content = content
    )
}

修改后固定浅色：

@Composable
fun MyAppTheme(
    // 硬编码关闭深色模式，不跟随系统设置
    darkTheme: Boolean = false,
    content: @Composable () -> Unit
) {
    // 直接固定使用浅色配色
    val colorScheme = LightColorScheme
    MaterialTheme(
        colorScheme = colorScheme,
        typography = Typography,
        content = content
    )
}

2. 补充原生层配置，避免系统强制触发深色 #

确认你已经正确添加以下两个配置，防止Android 10及以上系统强制给应用套深色模式：

• 在res/values/styles.xml的App基础主题下添加配置：

  <item name="android:forceDarkAllowed" tools:targetApi="q">false</item>
  

  确保你所有的Activity都使用该主题。
• 在Application的onCreate方法中，添加全局模式配置，该调用需要放在setContent之前：

  AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_NO)
  

3. 极端场景兜底方案 #

如果经过上述配置后仍有个别场景出现深色模式，可在Activity层级强制覆盖系统配置：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_NO)
    setContent {
        // 强制修改Context的UI模式为浅色
        val modifiedConfig = Configuration(resources.configuration).apply {
            uiMode = uiMode and Configuration.UI_MODE_NIGHT_MASK.inv() or Configuration.UI_MODE_NIGHT_NO
        }
        val lightContext = createConfigurationContext(modifiedConfig)
        CompositionLocalProvider(LocalContext provides lightContext) {
            MyAppTheme {
                // 应用根页面内容
            }
        }
    }
}

注意：不要在项目任意位置手动调用修改深色模式的API，也不要给主题配置暗色相关的style属性，避免覆盖全局配置

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