Android Studio Arctic Fox中buildSrc内代码自动补全失效问题

核心原因 #

• 版本不一致问题
  你根项目Kotlin版本为1.4.32，但buildSrc模块引入的kotlin("jvm")插件版本是1.4.31，跨版本Kotlin配置会导致Android Studio索引逻辑混乱，无法正确识别buildSrc内的依赖类。
• 脚本classpath隔离问题
  你在buildSrc/build.gradle.kts中导入Android相关类报错属于正常行为：buildSrc的build.gradle.kts是用来配置buildSrc模块本身构建逻辑的，dependencies块内配置的com.android.tools.build:gradle-api等依赖，只会供给buildSrc/src/main/目录下的插件源码使用，不会加入到buildSrc/build.gradle.kts自身的脚本classpath中。而app模块的build.gradle.kts因为应用了com.android.application插件，插件会自动将Android DSL相关类注入到脚本classpath中，所以可以正常导入。
• Arctic Fox版本IDE已知bug
  你使用的Arctic Fox版本对buildSrc的Kotlin DSL支持存在索引缺陷，尤其是brew安装的版本，经常出现依赖引入正确、构建正常，但IDE补全报错、提示Unresolved reference的问题，属于IDE索引缓存异常。

修复方案 #

• 统一Kotlin版本：将buildSrc的build.gradle.kts中kotlin("jvm")的版本改为1.4.32，和根项目Kotlin版本完全对齐。
• 清理IDE缓存：点击菜单栏 File -> Invalidate Caches...，勾选「Clear file system cache and local history」后重启Android Studio，等待索引完成即可恢复补全。
• 手动触发buildSrc构建：终端执行 ./gradlew buildSrc:compileKotlin，构建完成后会强制IDE重新扫描buildSrc的依赖类。
• 不要在buildSrc的构建脚本中导入Android DSL类：自定义插件代码都在buildSrc/src/main/kotlin目录下，该路径下的文件导入com.android.build.api.dsl.*完全正常，无需修改buildSrc自身的构建脚本。

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