Android自定义CheckBox样式失效：按教程操作仍显示灰色方块

核心错误：资源引用与文件名不匹配 #

你在category_spinner_dropdown_item.xml的CheckBox中引用的选择器是@drawable/custom_checkbox_selector，但实际的选择器文件名是custom_check_box_selector.xml（注意checkbox是连写，而文件名里是check_box带下划线）。系统找不到对应资源时，会自动 fallback 到默认的CheckBox样式，也就是你看到的灰色方块。

解决办法：

• 要么将选择器文件名改为custom_checkbox_selector.xml，保持和引用一致；
• 要么修改CheckBox的android:button属性为@drawable/custom_check_box_selector，匹配现有文件名。

其他可能的排查点 #

• 资源放置校验：确认custom_checkbox.png和custom_checkbox_checked.png放在res/drawable（或对应dpi的子目录，如drawable-mdpi）下，文件名完全一致，没有大小写错误（Android资源文件名区分大小写）。
• AppCompat主题适配：如果项目使用Theme.AppCompat或Theme.MaterialComponents系列主题，建议用app:buttonCompat替代android:button来设置自定义选择器，避免主题默认样式覆盖：

  <CheckBox
      android:id="@+id/categorySpinnerDropdownItemCheckBox"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      app:buttonCompat="@drawable/custom_checkbox_selector"
      android:background="@android:color/transparent"/>
  

• 宽高限制调整：你设置的35dp宽、20dp高可能会压缩图片，先改为wrap_content测试，确认图片能正常显示后再根据需求调整尺寸。

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