如何解决Dialog中Error inflating class CheckBox异常？

先排查布局文件中的CheckBox问题 #

Error inflating class CheckBox 大多源于布局中CheckBox的资源或属性配置错误，优先检查以下几点：

• 引用的资源是否存在：比如android:background="@drawable/xxx"里的Drawable文件、android:text="@string/xxx"里的字符串是否未定义或拼写错误
• 主题引用是否有效：android:theme="@style/xxx"指定的主题是否存在，或主题中包含CheckBox不支持的属性
• 自定义CheckBox类路径是否正确：如果用了自定义CheckBox，确保全类名（如com.example.MyCheckBox）书写无误

示例布局检查：

<CheckBox
    android:id="@+id/dialog_checkbox"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="@string/agree_terms"
    android:background="@drawable/checkbox_normal" />

确认@string/agree_terms和@drawable/checkbox_normal在项目中存在。

正确使用ViewBinding初始化Dialog布局 #

放弃findViewById，直接用ViewBinding的标准方式加载布局，避免手动查找View的错误：

class CustomDialog(context: Context) : Dialog(context) {
    private val binding: DialogCustomBinding

    init {
        // 使用Dialog内部的layoutInflater加载布局，确保上下文匹配
        binding = DialogCustomBinding.inflate(layoutInflater)
        setContentView(binding.root)
        
        // 直接通过binding访问组件，无需findViewById
        binding.dialogCheckbox.isChecked = true
    }
}

注意：不要用LayoutInflater.from(context).inflate(...)，Dialog内部的layoutInflater已经关联了正确的窗口上下文。

检查Dialog的Context参数 #

如果创建Dialog时传入Application Context（如getApplicationContext()），会导致主题资源加载失败，因为Application Context没有绑定Activity的主题。必须传入Activity/Fragment的上下文：

// 错误示例：使用Application Context
val dialog = CustomDialog(applicationContext)

// 正确示例：在Activity中传入自身Context
val dialog = CustomDialog(this)

// 正确示例：在Fragment中传入关联的Activity Context
val dialog = CustomDialog(requireContext())

确认ViewBinding启用配置 #

检查Module级别的build.gradle，确保已正确启用ViewBinding：

android {
    ...
    buildFeatures {
        viewBinding true
    }
}

旧版Gradle使用以下配置：

android {
    ...
    viewBinding {
        enabled = true
    }
}

清理缓存并重建项目 #

如果以上配置都正确仍报错，尝试清理项目缓存：

• 点击Android Studio菜单栏 Build > Clean Project
• 执行 Build > Rebuild Project
• 或手动删除项目根目录的.gradle和build文件夹后重新编译

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