IntelliJ中Scala async导入失效 报async不是scala成员错误

报错表现 #

导入语句执行失败，IDE抛出如下错误：

value async is not a member of scala

对应失效的导入代码：

import scala.async.Async.{async, await}

异步相关接口无法正常调用。

问题根因 #

• async/await 不属于Scala标准库内置API，是官方维护的扩展模块scala-async提供的能力，未引入对应依赖时会直接报该错误
• 依赖引入后未触发IDE索引刷新，或IDEA缓存损坏，导致已存在的依赖无法被IDE识别
• 依赖版本和项目使用的Scala大版本不匹配，比如Scala 2.12项目引入了适配Scala 2.13的async包
• 项目Scala SDK配置异常，存在多版本Scala冲突

修复步骤 #

1. 引入版本匹配的scala-async依赖 #

根据项目使用的构建工具和Scala版本，添加对应依赖：

• SBT项目：在build.sbt中添加配置

// Scala 2.12/2.13 通用
libraryDependencies += "org.scala-lang.modules" %% "scala-async" % "1.0.1"

注：Scala 3 版本已原生支持async/await语法，若需兼容旧版写法可引入上述依赖，否则可直接使用内置语法

• Maven项目：在pom.xml的<dependencies>节点下添加配置，注意artifactId后缀需和项目Scala大版本一致，比如Scala 2.13对应scala-async_2.13

<dependency>
    <groupId>org.scala-lang.modules</groupId>
    <artifactId>scala-async_2.13</artifactId>
    <version>1.0.1</version>
</dependency>

• Gradle项目：在构建脚本依赖块中添加配置，同样需匹配Scala版本后缀

// Scala 2.13 示例
implementation 'org.scala-lang.modules:scala-async_2.13:1.0.1'

2. 刷新项目依赖与索引 #

添加依赖后，点击IDEA侧边栏对应构建工具（sbt/Maven/Gradle）面板的刷新按钮，等待依赖拉取完成、IDE索引构建进度条加载完毕，再检查导入是否恢复正常。

3. 清除IDEA异常缓存 #

如果依赖已正确引入、版本匹配仍报错，执行缓存清理操作：

• 点击顶部菜单栏 File -> Invalidate Caches...
• 弹窗中勾选文件系统缓存、VCS日志缓存清理选项
• 点击Invalidate and Restart，等待IDEA重启完成索引重建后，导入即可正常识别。

4. 校验Scala SDK配置 #

打开Project Structure -> Project Settings -> Libraries/Modules，检查项目绑定的Scala SDK版本和引入的async依赖适配版本一致，移除多余的冲突版本Scala SDK即可。

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