AGP 8.0+ 必须在 android 块内使用 buildFeatures { viewBinding true } 启用 ViewBinding，viewBinding { enabled = true } 已废弃；绑定类按 layout 文件名生成，需确保文件名合法、含 android:id、位于 main/layout 下；Fragment 中需用 _binding 可空委托并及时置空防 NPE。
build.gradle 里必须写 buildFeatures { viewBinding = true }
不是 viewBinding { enabled = true }，也不是 android.viewBinding = true —— 这两种写法在 AGP 8.0+（即当前主流版本）中已失效，会直接编译失败或静默忽略。
正确位置是模块级 build.gradle（通常是 app/build.gradle）的 android 块内，且必须用 buildFeatures 闭包：
android {
compileSdk 34
buildFeatures {
viewBinding true
}
// 其他配置...
}
- AGP 7.0–7.4 支持
viewBinding { enabled = true }，但已标记为 deprecated；2026 年绝大多数新项目基于 AGP 8.4+，只认buildFeatures -
viewBinding true是布尔值，不能加引号，也不能写成"true"或True - 启用后无需 clean / rebuild 就能触发生成，但首次启用建议执行
./gradlew --stop && ./gradlew build确保缓存刷新
启用后 Binding 类没生成？检查 layout 文件名和 ID
ViewBinding 不是“全局开关”，它按布局文件逐个生成类：每个 XML 文件（如 activity_main.xml）对应一个 ActivityMainBinding 类。如果某个类没出现，大概率是以下原因：
- XML 文件名含非法字符（如横线、下划线开头、中文），例如
my-layout.xml→ 生成失败；应改为my_layout.xml或myLayout.xml - 布局根节点用了
tools:viewBindingIgnore="true"，该布局将被跳过，不生成任何绑定类 - 控件没写
android:id—— ViewBinding 只为带 ID 的视图生成字段，TextView没 ID 就不会出现在binding实例里 - 文件不在
src/main/res/layout/下（比如误放在layout-land或debug/目录），默认只处理主源集的 layout
Fragment 中 binding = null 报 NPE？生命周期没对齐
Fragment 的视图可能被重建（如配置变更、ViewPager 预加载），但 Fragment 实例还活着。直接声明 lateinit var binding: FragmentXBinding 会导致在 onDestroyView() 后继续访问已销毁的视图引用。
安全做法是用可空变量 + 生命周期感知委托：
private var _binding: FragmentXBinding? = null private val binding get() = _binding!!
-
_binding在onViewCreated()中赋值：_binding = FragmentXBinding.bind(view)（或inflate()） - 必须在
onDestroyView()末尾置空：_binding = null，否则可能引发内存泄漏或 NPE - 不要在
onCreate()或onAttach()里初始化 binding —— 此时 view 还未创建 - 若用
binding.root当返回值，确保只在onViewCreated()及之后调用
和 DataBinding 能共存吗？可以，但别混用同一布局
ViewBinding 和 DataBinding 可同时启用，Gradle 配置互不干扰：
buildFeatures {
viewBinding true
dataBinding true
}
但关键限制是：一个 XML 布局不能同时被两者处理。
- 含
<layout></layout>根标签的布局 → 只走 DataBinding 流程，ViewBinding 忽略它 - 普通根标签（
<linearlayout></linearlayout>等）→ 只生成 ViewBinding 类 - 试图在
<layout></layout>布局里调用XXXBinding.inflate()会编译报错，因为生成的是XXXBinding（DataBinding 类），不是XXXViewBinding - 共存时命名冲突极少，因 DataBinding 类名相同（如
ActivityMainBinding），但类型完全不同，IDE 能区分
真正容易出问题的地方是团队协作时有人忘了加 <layout></layout>，结果本该走 DataBinding 的布局被 ViewBinding 接管，导致 @BindingAdapter 失效或双向绑定断开 —— 这种问题 runtime 才暴露，很难 debug。
