Android Studio创建buildSrc后build.gradle.kts无法识别implementation问题求助

1 基础结构校验 #

• 确保buildSrc文件夹直接放置在项目根目录，与app模块、项目根build.gradle配置文件平级
• 确保buildSrc目录下存在src/main/kotlin（或src/main/java）目录，空目录可放置一个占位文件，避免Gradle无法识别为有效代码模块
• 检查项目根目录下的settings.gradle/settings.gradle.kts文件，确认没有手动排除buildSrc的配置，Gradle默认会自动识别根目录下的buildSrc模块，无需额外在settings中声明

2 配置文件修正 #

修改buildSrc目录下的build.gradle.kts，补充java-gradle-plugin插件，该插件会自动引入implementation、api等标准依赖配置：

plugins{
    `java-gradle-plugin`
    `kotlin-dsl`
}

repositories {
    google()
    mavenCentral()
    // 移除已废弃的jcenter仓库
}

dependencies {
    // 可先替换为硬编码版本号测试，排除rootProject.extra加载顺序问题
    // implementation("com.android.tools.build:gradle:7.0.4")
    // implementation("org.jetbrains.kotlin:kotlin-gradle-plugin:1.6.10")
    implementation(rootProject.extra["androidPlugin"].toString())
    implementation(rootProject.extra["kotlinPlugin"].toString())
}

额外校验根项目的属性定义：确保androidPlugin、kotlinPlugin两个ext属性已经在根build.gradle.kts或者settings.gradle.kts中提前定义，避免加载顺序导致的取值异常。

3 IDE索引异常修复 #

如果编译可以正常通过，仅Android Studio出现红色高亮报错，属于IDE索引异常问题，按以下步骤修复：

• 点击顶部菜单栏 File → Invalidate Caches
• 勾选Clear file system cache and local history选项，点击Invalidate and Restart
• 等待IDE重启完成，索引全部重建后查看是否恢复正常
• 如仍未恢复，可手动删除项目根目录下的.idea、.gradle文件夹，以及各模块的build文件夹，重新导入项目

内容的提问来源于stack exchange，提问作者鹏宇崔