color-state-list 状态顺序必须从具体到宽泛，因系统按序匹配首个满足条件项后即停止；应先写 state_pressed="true" 等具体状态，最后用无属性 item 作默认色，避免 state_pressed="false" 拦截其他状态。
color-state-list 里状态顺序为什么必须从具体到宽泛
Android 的 color-state-list 是按顺序匹配第一个满足条件的状态项，一旦匹配就停止查找。如果把 android:state_pressed="false" 放在前面，它会永远命中（因为绝大多数时候按钮都没被按着），后面所有状态都失效。
- 正确顺序：先写
android:state_pressed="true"、android:state_focused="true"等具体交互态，最后用不带属性的<item></item>作为默认色 - 常见错误现象：
button按下去没反应，或始终显示同一颜色 - 别写
android:state_pressed="false"—— 它不是“未按下”，而是“明确声明未按下”，反而会拦截掉其他状态匹配
Button 背景变色必须用 backgroundTint 还是 background
如果你用的是 MaterialButton 或设置了 Widget.Material3.Button 样式，直接设 android:background 会覆盖掉 Material 的涟漪和圆角逻辑，导致按压效果丢失或形状错乱。这时候该用 app:backgroundTint 配合 color-state-list。
- 传统
Button（继承自android.widget.Button）：用android:background引用color-state-list文件 -
MaterialButton：优先用app:backgroundTint，否则涟漪动画可能不触发或颜色错位 - 注意命名空间：
app:前缀需在根布局声明xmlns:app="http://schemas.android.com/apk/res-auto"
XML 里写 color-state-list 的常见写法和坑点
直接在 res/color/ 下新建 XML 文件（如 btn_primary.xml），内容不是随便堆 <item></item>，每个 <item></item> 的属性组合必须互斥且覆盖完整场景。
- 必须包含一个无任何 state 属性的
<item></item>作为兜底，否则未定义状态时会崩溃或取系统默认色 - 不要混用冲突状态，比如同时写
android:state_pressed="true"和android:state_enabled="false"在同一个<item></item>—— 按钮禁用时按下去，这个 item 就不会生效 - 示例（推荐写法）：
<?xml version="1.0" encoding="utf-8"?> <color-state-list xmlns:android="http://schemas.android.com/apk/res/android"> <item android:color="@color/red_600" android:state_pressed="true"/> <item android:color="@color/blue_500" android:state_focused="true"/> <item android:color="@color/grey_400" android:state_enabled="false"/> <item android:color="@color/blue_700"/> </color-state-list>
运行时报错 “ColorStateList not found” 或按压无效
这类问题基本不是代码逻辑错，而是资源路径或引用方式不对。最常踩的坑是把 color-state-list 放错目录，或者在 background 里误用了颜色值而非引用。
- 文件必须放在
res/color/目录下，不是res/values/或res/drawable/ - 引用时用
@color/btn_primary，不是@drawable/btn_primary或@color/blue_700（后者是单色，不是列表） - 检查 build 输出：如果 R 文件里没生成对应 id，说明 XML 文件名含大写字母、特殊符号，或根节点写成了
selector（那是 drawable 的写法） - 真机调试时，部分厂商 ROM 会忽略
state_focused，建议优先测试state_pressed和state_enabled
color-state-list 的支持程度不一致，比如 TextInputLayout 的 boxStrokeColor 接收的是 color-state-list，但它的状态语义和 Button 不同——它响应的是 state_focused 和 state_error，而不是 state_pressed。 
