如何在Kotlin Android项目中通过ViewBinding实现Fragment内Toolbar

错误原因说明 #

1. setContentView、setSupportActionBar 均为 AppCompatActivity 专属方法，Fragment 中没有这两个方法，直接调用自然会标红。
2. 你给 <include> 标签设置了 android:id 属性，导致 ViewBinding 生成的 binding.toolbar 类型为通用 View，而非 Toolbar，触发类型不匹配报错。
3. ViewBinding 初始化逻辑错误，重复调用绑定方法，未正确关联 Fragment 视图。

修复步骤 #

1. 修复XML类型不匹配问题 #

两种方案二选一即可：

• 方案1：去掉 <include> 标签的 android:id 属性，给 toolbar.xml 的根 Toolbar 控件添加id：

<!-- toolbar.xml -->
<?xml version="1.0" encoding="utf-8"?>
<androidx.appcompat.widget.Toolbar xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/toolbar"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="@color/teal_700"
    android:elevation="4dp">
</androidx.appcompat.widget.Toolbar>

<!-- fragment.xml 引入部分 -->
<include
    layout="@layout/toolbar" />

• 方案2：保留现有XML配置，获取Toolbar时手动强转：

val toolbar = binding.toolbar as androidx.appcompat.widget.Toolbar

2. 修正Fragment ViewBinding初始化与Toolbar配置逻辑 #

// 全局定义ViewBinding变量，注意判空处理避免内存泄漏
private var _binding: FragmentItemSecondBinding? = null
private val binding get() = _binding!!

override fun onCreateView(
    inflater: LayoutInflater,
    container: ViewGroup?,
    savedInstanceState: Bundle?
): View {
    // 正确初始化ViewBinding
    _binding = FragmentItemSecondBinding.inflate(inflater, container, false)
    // 将宿主Activity转为AppCompatActivity后调用setSupportActionBar
    (requireActivity() as AppCompatActivity).setSupportActionBar(binding.toolbar)
    
    // 其他逻辑
    binding.setProduct(product)
    return binding.root
}

override fun onDestroyView() {
    super.onDestroyView()
    // Fragment销毁视图时清空Binding，避免内存泄漏
    _binding = null
}

3. 实现Toolbar按钮功能 #

直接在 toolbar.xml 中添加按钮控件，无需通过Menu配置更简单：

<?xml version="1.0" encoding="utf-8"?>
<androidx.appcompat.widget.Toolbar xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/toolbar"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="@color/teal_700"
    android:elevation="4dp">

    <!-- 返回按钮 -->
    <ImageView
        android:id="@+id/btn_back"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:src="@mipmap/ic_back" <!-- 替换为你的返回图标 -->
        android:padding="12dp"/>

    <!-- 自定义操作按钮 -->
    <ImageView
        android:id="@+id/btn_custom"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:src="@mipmap/ic_more" <!-- 替换为你的自定义图标 -->
        android:padding="12dp"
        android:layout_gravity="end"/>

</androidx.appcompat.widget.Toolbar>

在Fragment中添加点击逻辑：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    // 返回上一级Fragment
    binding.btnBack.setOnClickListener {
        parentFragmentManager.popBackStack()
    }
    // 自定义操作
    binding.btnCustom.setOnClickListener {
        // 执行你的自定义逻辑
    }
}

常见疑问解答 #

androidx.appcompat.widget.Toolbar和android.support.v7.widget.Toolbar的区别 #

• android.support.v7.widget.Toolbar 是旧版安卓支持库组件，谷歌已于2018年停止维护，不再推送更新和bug修复。
• androidx.appcompat.widget.Toolbar 是AndroidX体系下的对应替代组件，所有新特性、兼容性优化都在该版本迭代，你当前使用前者是正确的，无需切换旧版本。

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