shape solid 的 android:color 必须是纯色值（如#ff6200ee），不能含主题属性引用；必须嵌套在shape根标签内且为直接子节点；android 12+ materialbutton需禁用backgroundtint以防覆盖。
shape solid 的 android:color 必须是合法颜色值，不能是资源引用别名
很多人写 android:color="@color/my_bg" 发现不生效，其实不是语法错，而是 @color/my_bg 指向的 XML 文件里用了 <color name="my_bg">?attr/colorSurface</color> 这类带主题属性引用的定义 —— shape 解析时无法动态求值，直接 fallback 成透明或默认黑。
实操建议：
- 确保
@color/my_bg是纯色值，例如#FF4285F4或@android:color/holo_blue_light - 如果要适配深色模式，别在
shape里硬编码，改用app:backgroundTint或主题级background属性控制 - 检查编译后
res/values/colors.xml是否被混淆工具（如 R8）意外移除了该 color 资源
XML 中 solid 必须嵌套在 shape 根标签内，顺序和层级不能错
常见错误是把 <solid android:color="#fff"></solid> 直接丢进 layout 文件，或者放在 selector 顶层 —— 它不是独立可用的 Drawable，只是 shape 的一个子元素。
正确结构只有这一种：
<shape xmlns:android="http://schemas.android.com/apk/res/android"
android:shape="rectangle">
<solid android:color="#FF6200EE" />
</shape>
注意：
-
android:shape值必须是rectangle、oval、line或ring，写错会导致运行时Resources$NotFoundException -
solid必须是shape的**直接子节点**，中间不能插gradient或stroke（除非你真需要叠加效果） - Android 12+ 上，如果 shape 用于
MaterialButton的 background，记得关掉app:backgroundTint，否则会覆盖solid颜色
颜色值带透明度时，十六进制必须是 8 位（#AARRGGBB），不是 6 位
写成 #6200EE 看似能编译，但实际解析为 #FF6200EE（自动补 FF 为不透明），导致深色模式下背景“突然变白”。
想设半透蓝？必须显式写全：
- ✅ 正确：
#806200EE（50% 透明度） - ❌ 错误：
#6200EE或android:color="@android:color/holo_blue_light"（后者不含 alpha） - ⚠️ 注意：系统预置 color 资源（如
@android:color/white）全是不透明的，没法直接拿来当半透色用
用 solid 设置背景色后，View 仍显示为灰色或不对，先查 backgroundTint 和主题继承
尤其在使用 Material 组件时，MaterialButton 或 TextInputLayout 默认会读取主题里的 colorOnSurface 或 colorPrimary 并应用 backgroundTint，直接盖掉 XML 里写的 solid 颜色。
排查步骤：
- 在布局中显式加
android:backgroundTint="@null"或app:backgroundTint="@null" - 确认当前 Activity 主题是否继承自
Theme.Material3.*，这类主题对 background 有强干预逻辑 - 用 Layout Inspector 查看 runtime 的 actual background drawable，确认加载的是不是你写的那个 shape 文件
真正难搞的不是怎么写 solid，而是它总在你没意识到的地方被更高优先级的 tint 或 theme 层叠规则悄悄覆盖。
