导入Kotlin多平台common模块至Android项目后IDE报语法错误但构建正常

我之前也碰到过一模一样的情况，早期Android Studio对Kotlin多平台（KMP）Common模块的IDE支持确实有不少坑。你的问题核心在于：Gradle能正确解析依赖完成构建，但Android Studio的索引系统没能识别Common模块的Kotlin标准库，导致出现假的语法报错。下面是几个针对性的解决方案：

1. 对齐Kotlin插件与项目版本 #

你的项目用的是Kotlin 1.2.41，但Android Studio自带的Kotlin插件版本可能和这个不一致。打开Settings -> Plugins -> Kotlin，检查插件版本是否为1.2.41。如果不匹配，手动下载对应版本的插件并重启IDE——版本不一致是IDE无法识别Common模块标准库的最常见原因。

2. 修正Common模块的SourceSet路径配置 #

你的Common模块build.gradle里的SourceSet配置有小问题：

sourceSets {
    main.kotlin.srcDirs += 'main/'
    test.kotlin.srcDirs += 'test/'
}

标准KMP模块的Kotlin源码目录应该是main/kotlin，而不是整个main/目录。IDE可能因为路径识别错误，无法关联到源码依赖的标准库。修改为：

sourceSets {
    main.kotlin.srcDirs += 'main/kotlin'
    test.kotlin.srcDirs += 'test/kotlin'
}

同步Gradle后，IDE就能正确识别源码结构了。

3. 清理IDE缓存并重启 #

IDE缓存紊乱是这类“构建正常但IDE报错”问题的典型元凶。执行以下步骤：

• 点击顶部菜单栏File -> Invalidate Caches / Restart...
• 在弹窗中选择Invalidate and Restart
  等待IDE重启并重新索引项目，大部分假语法报错会自动消失。

4. 显式声明Android项目对Common模块的依赖 #

确保Android项目B的app模块（或其他需要依赖Common的模块）build.gradle中，明确添加对Common模块的依赖：

dependencies {
    // 其他依赖...
    implementation project(':common')
}

虽然你已经在settings.gradle中导入了模块，但显式声明依赖能帮助IDE更清晰地解析模块间的依赖关系。

5. 升级IDE和Kotlin版本（可选但推荐） #

你用的Android Studio 3.1.2和Kotlin 1.2.41都是比较早期的版本，当时KMP的IDE支持还很不完善。如果项目允许，升级到Android Studio 3.5+和Kotlin 1.3+，能大幅改善KMP模块的IDE体验，减少这类奇怪的索引问题。

另外你提到IDEA Ultimate 2018.1没问题，这是因为同期IDEA对Kotlin多平台的支持比Android Studio更成熟，AS的KMP支持是后续版本才逐步跟上的。

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