AppCompat SearchView文字颜色修改失效：预览为黑模拟器显示为白

常见原因 #

• 主题覆盖冲突：仅修改了单目录下的themes.xml，未适配values-night等带资源限定符的主题文件，或者运行时Activity、Toolbar/ActionBar的主题覆盖了全局配置的SearchView样式。
• 样式配置错误：未指定正确的SearchView样式作用域，直接修改全局textColor属性会被AppCompat SearchView自带的默认样式覆盖，不生效。
• 预览与运行环境不匹配：布局预览选择的API版本、主题和模拟器运行的环境不一致，预览加载的是修改后的主题，运行时实际加载的是未修改的默认主题。

解决步骤 #

1. 检查多目录主题配置
   确认values、values-night、values-vXX（对应高API版本）目录下的themes.xml都做了统一配置，若无需适配夜间模式，可先在ActivityonCreate的setContentView前添加代码强制关闭夜间模式测试：

AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_NO)

2. 配置正确的自定义SearchView样式
   在你的主App主题中指定自定义SearchView样式，避免样式被覆盖，示例配置如下：

<!-- 主App主题 -->
<style name="Theme.YourAppName" parent="Theme.MaterialComponents.DayNight.NoActionBar">
    <!-- 其余主题配置 -->
    <item name="searchViewStyle">@style/CustomSearchView</item>
</style>

<!-- 自定义SearchView样式 -->
<style name="CustomSearchView" parent="Widget.AppCompat.SearchView">
    <!-- 搜索输入文字颜色 -->
    <item name="android:textColor">@color/black</item>
    <!-- 搜索提示文字颜色 -->
    <item name="android:textColorHint">@color/dark_grey</item>
</style>

3. 适配Menu加载场景
   如果SearchView是通过onCreateOptionsMenu加载到Toolbar/ActionBar上的，需要给Toolbar单独指定主题，避免被Toolbar默认样式覆盖：

<androidx.appcompat.widget.Toolbar
    android:id="@+id/toolbar"
    android:layout_width="match_parent"
    android:layout_height="?attr/actionBarSize"
    android:theme="@style/Theme.YourAppName.ToolbarOverlay"
    app:popupTheme="@style/ThemeOverlay.MaterialComponents.Light"/>

对应的主题配置：

<style name="Theme.YourAppName.ToolbarOverlay" parent="ThemeOverlay.MaterialComponents.Dark.ActionBar">
    <item name="searchViewStyle">@style/CustomSearchView</item>
</style>

4. 检查Manifest主题配置
   确认AndroidManifest.xml中对应Activity的android:theme属性，配置的是你修改后的自定义主主题，而非系统默认主题。

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