启用深色主题后Android中com.google.android.material.chip.Chip组件不可见的问题排查

你遇到的核心问题是：Chip的默认背景色和卡片的colorSurface在深色模式下完全重合，导致Chip的背景被"淹没"，只能看到文本和点击波纹。这是因为你没有给Chip指定适配深浅模式的专属背景色属性。

快速修复：直接给Chip设置主题适配的背景色 #

最简单的方式就是在Chip的XML代码中添加app:chipBackgroundColor属性，使用Material Components主题提供的动态颜色属性——这些属性会自动根据深浅模式切换对应的颜色值：

<com.google.android.material.chip.Chip
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:textColor="?android:attr/textColorPrimary"
    android:text="@string/chip_text"
    app:chipBackgroundColor="?attr/colorSurfaceVariant" />

这里推荐使用?attr/colorSurfaceVariant，它是Material Design中定义的、与colorSurface有清晰区分度的辅助表面色，在浅色和深色模式下都会和卡片背景形成自然对比。你也可以尝试?attr/colorSecondaryContainer，根据你的主题色调选择最合适的选项。

自定义全局Chip样式（推荐） #

如果你希望所有Chip都自动应用适配逻辑，避免每个Chip重复写属性，可以在主题中全局配置Chip样式：

1. 先定义一个自定义的Chip样式：

<style name="MyAppChipStyle" parent="Widget.MaterialComponents.Chip.Entry">
    <!-- 设置适配深浅模式的背景色 -->
    <item name="chipBackgroundColor">?attr/colorSurfaceVariant</item>
    <!-- 还可以在这里统一设置其他属性，比如文本颜色、圆角等 -->
    <item name="android:textColor">?android:attr/textColorPrimary</item>
</style>

2. 在你的应用主题中引用这个样式：

<style name="Theme.MyTheme" parent="Theme.MaterialComponents.DayNight.NoActionBar">
    <!-- 保留你已有的主题属性 -->
    <item name="colorPrimary">@color/primaryColor</item>
    <item name="colorPrimaryVariant">@color/primaryVariantColor</item>
    <!-- 添加这行，全局应用Chip样式 -->
    <item name="chipStyle">@style/MyAppChipStyle</item>
</style>

问题根源说明 #

当使用Theme.MaterialComponents.DayNight主题时，如果没有显式设置chipBackgroundColor，Chip会默认使用与colorSurface接近的颜色值——而你的卡片背景正好是?attr/colorSurface，所以在深色模式下两者颜色几乎完全重合，就只能看到文本和点击时的波纹效果了。

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