Android Studio无法识别KMM共享模块commonMain依赖的解决方法

• 强制刷新Gradle依赖

  • 点击Android Studio右上角的Gradle同步按钮（大象图标），或用快捷键Ctrl+Shift+O（Windows/Linux）/Cmd+Shift+O（Mac）触发同步。
  • 若同步无效，在终端执行对应系统的命令强制刷新：
    Linux/Mac：./gradlew clean build --refresh-dependencies
    Windows：gradlew clean build --refresh-dependencies

• 检查依赖配置正确性

  • 确认依赖是添加在共享模块的commonMain源集下，示例正确配置：

    sourceSets {
        val commonMain by getting {
            dependencies {
                implementation("org.jetbrains.kotlinx:kotlinx-datetime:0.4.0")
            }
        }
    }
    

  • 核对依赖的Maven坐标和版本号，避免拼写错误。

• 清理IDE缓存并重启

  • 打开File菜单选择Invalidate Caches...，勾选Invalidate and Restart，等待IDE重启重建索引。
  • 也可手动删除缓存目录后重启：
    Windows：C:\Users\<你的用户名>\.AndroidStudioFlamingo\system\caches
    Ubuntu：~/.AndroidStudioFlamingo/system/caches

• 检查KMM插件兼容性

  • 进入Settings（Windows/Linux：File > Settings；Mac：Android Studio > Settings）→Plugins，确认Kotlin Multiplatform Mobile插件已更新到与Flamingo版本匹配的最新版，更新后重启IDE。

• 验证模块配置

  • 确保共享模块的build.gradle.kts（或.gradle）正确应用KMM插件：

    plugins {
        kotlin("multiplatform")
        id("com.android.library")
    }
    

  • 检查kotlin块中目标平台声明完整，示例：

    kotlin {
        androidTarget()
        iosX64()
        iosArm64()
        iosSimulatorArm64()
    
        sourceSets {
            // 源集配置
        }
    }
    

• 核对Gradle版本

  • 项目根目录gradle/wrapper/gradle-wrapper.properties中，Gradle版本需与IDE、KMM插件兼容，Flamingo推荐使用7.4及以上版本，示例：

    distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
    

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