Android Studio中自定义Button样式不生效 无法覆盖项目默认样式

你的应用主题继承自Theme.MaterialComponents系列，这种场景下，布局里直接写的<Button>标签，在运行时会被系统自动替换为com.google.android.material.button.MaterialButton组件。
这个Material组件自带固定的默认样式逻辑：

• 默认自动用colorPrimary作为按钮的填充背景
• 会拦截开发者手动设置的android:background属性，不让自定义的背景生效
  这就导致你写的自定义圆角、渐变配置完全不生效，只有文字大小、颜色这类属性能正常起作用。

方案1：使用原生Button（零额外适配成本） #

如果你不需要Material按钮自带的水波纹、按压动效这类特性，只想完全自主控制按钮外观，直接把布局中的按钮标签替换为完整类名的原生平台Button，就能绕过系统的自动替换逻辑：

<android.widget.Button
    android:id="@+id/button"
    style="@style/buttonStartStyle"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="Button"
    tools:layout_editor_absoluteX="121dp"
    tools:layout_editor_absoluteY="244dp" />

替换后你之前写的所有自定义样式、drawable配置都会正常生效，没有额外的拦截逻辑。

方案2：适配MaterialButton的样式规则 #

如果你希望保留Material按钮的原生交互效果，只需要微调自定义样式的配置，不需要更换控件类型：

1. 给按钮样式指定正确的父样式，补上关闭默认背景着色的配置，就不会再出现自定义背景被覆盖的问题：

<style name="buttonStartStyle" parent="Widget.MaterialComponents.Button">
    <!-- 关闭Material默认叠加的背景着色，让自定义drawable正常显示 -->
    <item name="backgroundTint">@null</item>
    <!-- 保留你原有定义的所有配置即可 -->
    <item name="android:background">@drawable/button_style1</item>
    <item name="android:layout_margin">20dp</item>
    <item name="android:textColor">@color/white</item>
    <item name="android:textAllCaps">false</item>
    <item name="android:textSize">18sp</item>
    <item name="android:layout_width">match_parent</item>
    <item name="android:layout_height">wrap_content</item>
</style>

2. 修正drawable配置里的冲突问题：你在button_style1.xml的shape中同时写了solid实色填充和gradient渐变配置，这两个属性共存时，实色填充会覆盖渐变效果。删除多余的solid配置，渐变才能正常显示：

<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item>
        <shape android:shape="rectangle">
            <corners android:radius="50dp"/>
            <!-- 删除这行会覆盖渐变的实色配置 -->
            <!-- <solid android:color="@color/smoothWhite"/> -->
            <size android:height="50dp"/>
            <gradient 
                android:startColor="@color/green_card" 
                android:endColor="@color/green_main"/>
        </shape>
    </item>
</selector>

布局文件中直接给控件标签设置的android:layout_width、android:layout_height属性，优先级高于样式文件中定义的同属性值。如果你希望样式里写的宽高配置生效，把布局标签里单独写的宽高代码删掉就行，这是正常的优先级规则，不是系统bug。

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