Android Studio中ViewBinding配置失败，求解决方案

针对你在Gradle 8.3+Android插件8.1.1环境下遇到的ViewBinding配置失效问题，按以下步骤排查解决：

1. 确认配置的正确位置与语法 #

必须在模块级（Module）的build.gradle或build.gradle.kts文件的android代码块内配置，项目级（Project）的build.gradle无法配置该属性。

正确的Groovy语法（.gradle文件）：

android {
    // 其他配置：compileSdk、defaultConfig等
    buildFeatures {
        viewBinding true
    }
}

或等价写法：

android {
    // 其他配置
    viewBinding {
        enabled = true
    }
}

如果使用Kotlin DSL（.gradle.kts文件），语法为：

android {
    buildFeatures {
        viewBinding = true
    }
}

你之前尝试的buildFeatures { viewBinding { enabled = true } }属于错误写法，会触发语法报错。

2. 排查布局文件的问题 #

• 确保布局文件未添加tools:viewBindingIgnore="true"属性，该属性会禁止生成对应布局的Binding类。
• 若布局以<merge>为根标签，在Activity/Fragment中绑定需额外传入父布局参数；普通Activity布局建议使用常规ViewGroup（如LinearLayout、ConstraintLayout）作为根节点。
• 布局中的<include>标签必须指定android:id，否则会导致Binding类生成异常。

3. 清理与重建项目 #

执行以下操作彻底清除缓存：

• 点击Android Studio顶部菜单栏的File > Invalidate Caches... > Invalidate and Restart，重启IDE。
• 手动删除项目根目录下的.gradle、build文件夹，以及模块目录下的build文件夹，重新同步Gradle。

4. 检查依赖与版本兼容性 #

Gradle插件8.1.1要求Kotlin版本至少为1.8.20，确认模块级build.gradle中的Kotlin版本配置正确：

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
}

android {
    // ...
}

dependencies {
    // 确保Kotlin标准库版本与插件兼容
    implementation 'org.jetbrains.kotlin:kotlin-stdlib:1.8.20'
    // 其他依赖
}

5. 验证绑定代码的写法 #

Activity中正确初始化Binding类的示例：

import com.example.mvvmstudy.databinding.ActivityMainBinding

class MainActivity : AppCompatActivity() {
    private lateinit var binding: ActivityMainBinding

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(binding.root)
        
        // 测试绑定是否生效
        binding.button.setOnClickListener {
            Toast.makeText(this, "绑定成功", Toast.LENGTH_SHORT).show()
        }
    }
}

若以上步骤执行后仍有问题，检查Android Studio版本与Gradle版本是否匹配——Gradle 8.3建议搭配Android Studio Hedgehog（2023.1.1）及以上版本。

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