Android Studio添加Kotlin模块后陷入「扫描文件以建立索引」循环求助

阿华AIGC实验室

2026-5-22

解决Android Studio添加Kotlin模块后持续循环索引的问题

我之前也遇到过几乎一模一样的情况——把默认app模块重命名后添加Kotlin库模块，结果IDE就卡在「扫描文件建立索引」的循环里停不下来。折腾了好几个小时，终于找到了几个靠谱的解决方向，你可以逐一排查：

一、先检查模块配置和依赖关系，这是最常见的根源

确保projectB是纯Kotlin JVM库模块，而不是Android应用/库模块。如果不小心创建成Android模块，IDE会反复扫描Android资源文件导致循环。正确的projectB/build.gradle.kts开头应该是这样的：
```
plugins {
    kotlin("jvm") version "你的Kotlin版本号"
    // 绝对不能有com.android.application或com.android.library插件！
}
```
排除循环依赖：检查projectA和projectB的依赖链，别让A依赖B的同时B又依赖A。projectA里的依赖声明应该是：
```
dependencies {
    implementation(project(":projectB"))
}
```

确认settings.gradle.kts里的模块注册没有重复或路径错误：

include(":projectA", ":projectB")
// 指定模块的实际目录，避免IDE找错位置
project(":projectA").projectDir = file("projectA")
project(":projectB").projectDir = file("projectB")

二、清理IDE缓存和索引，90%的索引问题都能这么解决

这是我每次遇到索引bug的第一操作：

点击顶部菜单栏的 File → Invalidate Caches...，选择Invalidate and Restart，让IDE彻底重启并重建索引。
如果还是不行，手动删IDE缓存目录更彻底：
- Windows：C:\Users\<你的用户名>\.AndroidStudio<版本号>\system\caches
- Mac：~/Library/Caches/Google/AndroidStudio<版本号>
- Linux：~/.AndroidStudio<版本号>/system/caches
  删除后重启IDE，一般就能解决循环问题。

三、让IDE别扫描无关文件

有时候projectB里的构建产物、日志或者第三方依赖包会被IDE误扫描，导致循环：

在projectB的根目录新建gradle.properties，添加这些配置优化索引：
```
org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
kotlin.incremental=true
```

或者在projectB/build.gradle.kts里明确指定源码目录，避免IDE乱扫：

sourceSets {
    main {
        kotlin.srcDirs("src/main/kotlin")
        resources.srcDirs("src/main/resources")
    }
    test {
        kotlin.srcDirs("src/test/kotlin")
        resources.srcDirs("src/test/resources")
    }
}

还可以在File → Settings → Editor → File Types里，把.log、.tmp这类无关文件添加到Ignored Files and Folders列表里，让IDE直接跳过它们。

四、检查IDE和Kotlin版本的兼容性

旧版本的Android Studio和Kotlin插件可能存在索引bug：

确保Android Studio版本和Kotlin插件版本匹配，比如最新的Hedgehog版本需要Kotlin 1.9.0+。你可以在Tools → Kotlin → Configure Kotlin Plugin Updates里检查并更新。
如果用的是比较老的IDE版本，直接升级到稳定版试试，很多索引循环的bug在新版本里已经修复了。