android.widget.Toolbar无法转换为androidx.appcompat.widget.Toolbar如何解决

该报错本质是代码引用的Toolbar包与布局声明的Toolbar包不匹配导致的类型冲突：你在MainActivity.kt中导入的是兼容包提供的androidx.appcompat.widget.Toolbar，但activity_main.xml里使用的是系统原生的android.widget.Toolbar，运行时类型转换不兼容就会抛出该异常。

方案1：统一使用AndroidX兼容包Toolbar（推荐） #

该方案可兼容更低系统版本，也是Android官方推荐的用法：

• 修改activity_main.xml中的Toolbar节点，将默认的<Toolbar>标签替换为完整的AndroidX包名声明：

<!-- 错误写法示例 -->
<Toolbar
    android:id="@+id/toolbar"
    android:layout_width="match_parent"
    android:layout_height="?attr/actionBarSize" />

<!-- 修正后的写法 -->
<androidx.appcompat.widget.Toolbar
    android:id="@+id/toolbar"
    android:layout_width="match_parent"
    android:layout_height="?attr/actionBarSize" />

• 保持MainActivity.kt中已有的import androidx.appcompat.widget.Toolbar导入语句不变，重新编译运行即可。

方案2：统一使用系统原生Toolbar（仅适用于minSdk≥21的项目） #

如果你的项目不需要兼容Android 5.0以下版本，也可以直接修改代码的导入包：

• 删除MainActivity.kt中原有的androidx.appcompat.widget.Toolbar导入语句，替换为原生包导入：

import android.widget.Toolbar

• 注意使用该方案时需要确认当前Activity的主题未配置windowActionBar等冲突属性，避免出现Toolbar渲染异常。

如果修改后仍报错，先执行Android Studio的Build > Clean Project再Rebuild Project，清除缓存的布局绑定类即可解决。如果项目还存在Support库和AndroidX库混合依赖的情况，建议执行Refactor > Migrate to AndroidX统一所有依赖包，避免后续出现同类包名冲突问题。

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