SwitchPreferenceCompat真机关闭状态颜色异常，是库bug还是操作有误？

这个问题既不是你的操作错误，也不完全是Preference库的bug，核心原因是MIUI 12.5的定制主题与Material3主题、旧版Preference库的兼容性冲突——MIUI会对系统控件的样式做深度定制，而androidx.preference:1.2.0对Material3主题的适配不够完善，导致真机上Switch的关闭状态颜色被MIUI的定制样式覆盖。

以下是几个可行的解决办法：

1. 升级Preference库版本 #

androidx.preference:1.2.0是较旧的版本，对Material3主题的支持存在局限性。建议升级到最新稳定版（如1.2.1或更高），新版本修复了不少兼容性问题：
修改Module级别build.gradle中的依赖：

implementation "androidx.preference:preference:1.2.1"
// 若使用Kotlin，替换为
// implementation "androidx.preference:preference-ktx:1.2.1"

2. 为Preference指定兼容主题 #

在应用主题Theme.Notes中添加Preference专属主题属性，强制使用官方样式，避免MIUI的定制干扰：

<style name="Theme.Notes" parent="Theme.Material3.DayNight.NoActionBar">
    <!-- 保留原有属性 -->
    <item name="preferenceTheme">@style/PreferenceThemeOverlay.Material3</item>
</style>

如果Material3主题仍有问题，可以 fallback 到Material主题：

<item name="preferenceTheme">@style/PreferenceThemeOverlay.Material</item>

3. 自定义Switch关闭状态颜色 #

直接通过样式定制Switch的拇指和轨道颜色，完全覆盖MIUI的默认样式：

步骤1：创建颜色选择器 #

在res/color目录下创建两个选择器文件：

• switch_thumb_selector.xml（控制开关拇指颜色）：

<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:color="@color/white" android:state_checked="false"/> <!-- 关闭状态颜色 -->
    <item android:color="@color/color_primary" android:state_checked="true"/> <!-- 开启状态颜色 -->
</selector>

• switch_track_selector.xml（控制开关轨道颜色）：

<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:color="@color/grey_400" android:state_checked="false"/> <!-- 关闭状态颜色 -->
    <item android:color="@color/color_primary_alpha" android:state_checked="true"/> <!-- 开启状态颜色 -->
</selector>

注：grey_400和color_primary_alpha需在colors.xml中自行定义（例如#CCCCCC和#80[你的primary颜色值]）。

步骤2：自定义Switch控件布局 #

在res/layout目录下创建custom_switch_widget.xml：

<androidx.appcompat.widget.SwitchCompat
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@android:id/switchWidget"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:thumbTint="@color/switch_thumb_selector"
    android:trackTint="@color/switch_track_selector" />

步骤3：关联到SwitchPreferenceCompat #

修改preferences.xml，为组件指定自定义布局：

<SwitchPreferenceCompat
    app:key="@string/auth_key"
    app:title="@string/auth_title"
    android:icon="@drawable/ic_fingerprint"
    app:widgetLayout="@layout/custom_switch_widget" />

4. 检查MIUI主题设置 #

如果手机使用了第三方MIUI主题，建议切换到MIUI默认主题测试——第三方主题往往会强制修改系统控件样式，导致自定义样式失效。

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