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() 后继续访问已销毁的视图引用。

安全做法是用可空变量 + 生命周期感知委托：

Android SMS Gateway

自托管短信服务，使用 Android 手机作为网关提供 HTTP API，支持发送/接收短信，兼容主流短信网关。

下载

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 布局不能同时被两者处理。

• 含 根标签的布局 → 只走 DataBinding 流程，ViewBinding 忽略它
• 普通根标签（ 等）→ 只生成 ViewBinding 类
• 试图在 布局里调用 XXXBinding.inflate() 会编译报错，因为生成的是 XXXBinding（DataBinding 类），不是 XXXViewBinding
• 共存时命名冲突极少，因 DataBinding 类名相同（如 ActivityMainBinding），但类型完全不同，IDE 能区分

真正容易出问题的地方是团队协作时有人忘了加 ，结果本该走 DataBinding 的布局被 ViewBinding 接管，导致 @BindingAdapter 失效或双向绑定断开 —— 这种问题 runtime 才暴露，很难 debug。