Android Studio构建报错：无法确定?attr/colorSurface标签类型

问题成因 #

?attr/colorSurface 是Material Design主题的内置属性，触发这个错误主要有几个原因：

• 版本不匹配：你用的Material库版本是1.7.0，但compileSdk仅设置为32。Material 1.7.0开始部分属性依赖Android 13（API 33）的SDK定义，32版本无法正确解析这些属性。
• 主题配置错误：空模板默认使用Material主题，但如果你的styles.xml里没正确继承MaterialComponents主题，或者混用了AppCompat主题，会导致属性无法识别。
• Gradle插件兼容问题：你用的Gradle插件7.0.4版本较老，和新版Material库配合时存在兼容性bug。

解决方案 #

方案1：升级compileSdk到33及以上 #

修改build.gradle(:app)中的编译版本配置，让SDK版本适配Material库要求：

android {
    compileSdk 33

    defaultConfig {
        // 保留其他配置不变
        targetSdk 33
    }
    // 其他配置不变
}

方案2：降低Material库版本 #

如果暂时不想升级compileSdk，把Material库降到适配API 32的版本，比如1.6.1：

dependencies {
    // 保留其他依赖不变
    implementation 'com.google.android.material:material:1.6.1'
}

方案3：修正主题继承 #

打开res/values/styles.xml，确保主题正确继承MaterialComponents系列主题，不要用AppCompat主题：

<style name="Theme.NorthGuide" parent="Theme.MaterialComponents.DayNight.DarkActionBar">
    // 保留其他主题属性不变
</style>

方案4：升级Gradle插件版本 #

修改根目录build.gradle中的插件版本，换成更兼容的7.4.2：

buildscript {
    dependencies {
        classpath "com.android.tools.build:gradle:7.4.2"
        // 其他classpath配置不变
    }
}

同时更新gradle/wrapper/gradle-wrapper.properties里的Gradle版本，对应改成https\://services.gradle.org/distributions/gradle-7.5-bin.zip

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