如何高效为Android应用实现继承AppTheme的深浅色自定义主题

刚好我前段时间做项目时就用了类似的主题结构，给你分享一套高效的实现方案和技巧，完全契合你的需求：

1. 先梳理资源目录结构 #

首先把通用资源和主题专属资源分开：

• 尺寸、字体、通用样式放在res/values/目录下（不用区分深浅）
• 颜色资源分两套：res/values/colors.xml（浅色）、res/values-night/colors.xml（深色），系统会根据系统主题自动加载对应目录的资源

2. 优化主题层级（完全匹配你的继承需求） #

把通用的非颜色属性（字体、尺寸、ActionBar配置等）放在父主题AppTheme里，子主题只负责覆盖颜色属性，完美遵循DRY原则：

<!-- 父主题：存放通用样式，不定义颜色 -->
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
    <!-- 通用字体配置 -->
    <item name="android:fontFamily">@font/your_custom_font</item>
    <!-- 通用文本尺寸 -->
    <item name="android:textSize">@dimen/text_normal</item>
    <!-- 自定义ActionBar样式（通用部分） -->
    <item name="actionBarStyle">@style/CustomActionBar</item>
    <!-- 其他通用配置：比如窗口动画、按钮样式等 -->
</style>

<!-- 浅色主题：仅覆盖颜色属性 -->
<style name="AppTheme.Light" parent="AppTheme">
    <item name="colorPrimary">@color/light_primary</item>
    <item name="colorPrimaryDark">@color/light_primary_dark</item>
    <item name="colorAccent">@color/light_accent</item>
    <item name="android:windowBackground">@color/light_bg</item>
    <item name="android:textColorPrimary">@color/light_text_main</item>
</style>

<!-- 深色主题：仅覆盖颜色属性 -->
<style name="AppTheme.Dark" parent="AppTheme">
    <item name="colorPrimary">@color/dark_primary</item>
    <item name="colorPrimaryDark">@color/dark_primary_dark</item>
    <item name="colorAccent">@color/dark_accent</item>
    <item name="android:windowBackground">@color/dark_bg</item>
    <item name="android:textColorPrimary">@color/dark_text_main</item>
</style>

3. 规范管理颜色资源 #

在res/values/colors.xml里定义浅色主题的颜色：

<color name="light_primary">#2196F3</color>
<color name="light_primary_dark">#1976D2</color>
<color name="light_accent">#FF4081</color>
<color name="light_bg">#FFFFFF</color>
<color name="light_text_main">#212121</color>

新建res/values-night/colors.xml，对应定义深色主题的颜色：

<color name="dark_primary">#1976D2</color>
<color name="dark_primary_dark">#0D47A1</color>
<color name="dark_accent">#FF80AB</color>
<color name="dark_bg">#121212</color>
<color name="dark_text_main">#FFFFFF</color>

4. 统一尺寸与字体配置 #

• 把所有自定义尺寸放在res/values/dimens.xml，比如：

<dimen name="text_small">12sp</dimen>
<dimen name="text_normal">16sp</dimen>
<dimen name="text_large">20sp</dimen>
<dimen name="padding_normal">16dp</dimen>

• 自定义字体放在res/font/目录（Android 8.0+支持），在AppTheme里统一设置fontFamily，整个App的字体就自动统一了，不用每个TextView单独配置。

5. 主题切换的实用技巧 #

如果需要手动切换主题（而非跟随系统），可以在SharedPreferences保存用户选择，然后在BaseActivity的onCreate()中设置：

@Override
protected void onCreate(Bundle savedInstanceState) {
    // 先设置主题，再调用super.onCreate和setContentView
    applySavedTheme();
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
}

private void applySavedTheme() {
    SharedPreferences sp = getSharedPreferences("app_settings", MODE_PRIVATE);
    int themeType = sp.getInt("selected_theme", 0); // 0=跟随系统，1=浅色，2=深色
    switch (themeType) {
        case 1:
            setTheme(R.style.AppTheme_Light);
            break;
        case 2:
            setTheme(R.style.AppTheme_Dark);
            break;
        default:
            // Android 10+自动跟随系统夜间模式
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
                boolean isNight = (getResources().getConfiguration().uiMode & Configuration.UI_MODE_NIGHT_MASK) == Configuration.UI_MODE_NIGHT_YES;
                setTheme(isNight ? R.style.AppTheme_Dark : R.style.AppTheme_Light);
            } else {
                setTheme(R.style.AppTheme_Light);
            }
            break;
    }
}

6. 额外优化建议 #

• 推荐使用Theme.MaterialComponents.DayNight代替Theme.AppCompat.Light.DarkActionBar，原生支持日间/夜间切换，适配更省心
• 布局里尽量用主题属性（?attr/xxx）代替硬编码颜色，比如TextView的textColor用?attr/textColorPrimary，切换主题时自动更新
• 用Android Studio设计视图顶部的「Night Mode」开关，可以快速预览深浅主题效果，调试更高效

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