向Kotlin Multiplatform项目添加Coroutines时遇错误求助

以下是针对Kotlin 1.9.21版本，添加kotlinx.coroutines到commonMain时容易遗漏的关键环节：

• 确认依赖配置的正确性
  确保在commonMain的依赖块中添加的是多平台专用的coroutines核心依赖，而非单平台版本。正确的声明示例：

  sourceSets {
      val commonMain by getting {
          dependencies {
              implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3")
              // 注：Kotlin 1.9.21需搭配兼容的coroutines版本，1.7.3及以上版本适配该Kotlin版本
          }
      }
      // 其他平台sourceSets配置...
  }
  

  版本不匹配是常见问题，务必保证coroutines版本与Kotlin 1.9.21兼容。

• 检查项目插件配置
  确认根build文件中已正确应用Kotlin Multiplatform插件：

  plugins {
      kotlin("multiplatform") version "1.9.21"
      // 若包含Android目标，需额外应用com.android.library或com.android.application插件
  }
  

  无需额外添加coroutines专属插件，依赖声明即可生效。

• 执行Gradle同步与缓存清理
  添加依赖后，必须点击IntelliJ的「Sync Project with Gradle Files」按钮完成同步。若同步后问题仍存在：

  • 执行终端命令：./gradlew clean（Mac/Linux）或gradlew clean（Windows）清理构建缓存
  • 重启IntelliJ后再次同步项目

• 确认代码中的包导入
  在commonMain的Kotlin代码中，确保导入的是kotlinx.coroutines下的正确类：

  import kotlinx.coroutines.delay
  import kotlinx.coroutines.launch
  

  若IDE提示找不到包，基本是依赖未同步或版本不兼容导致。

• 检查平台专属配置（如有）
  若项目包含Android、iOS等目标平台，确保对应平台的sourceSets没有冲突的依赖声明。commonMain的依赖会自动传递到各平台sourceSets，但部分平台（如iOS）需确保框架导出配置正确（通常无需额外操作，但若有iOS编译错误可检查iosMain的依赖块）。

若以上步骤均确认无误，建议提供具体的错误信息（如编译报错日志、IDE红线提示内容），以便更精准定位问题。

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