如何配置IntelliJ以适配多Scala版本的SBT项目

问题场景 #

我有一个由SBT管理的Scala项目，源码目录结构如下：

src
 |-main
 |  |-scala
 |  |-scala-2
 |  |-scala-3 

其中：

• scala目录包含可在Scala 2和Scala 3下编译的代码
• scala-2目录包含Scala 2专属代码
• scala-3目录包含Scala 3专属代码

SBT可正常处理这三个目录，切换Scala 2和Scala 3版本、测试及发布对应JAR包均无问题。但使用IntelliJ开发时，无法同时适配两个Scala版本，例如仅能识别scala和scala-2目录，scala-3目录被忽略，导致该目录无法使用代码检查、自动补全等IntelliJ功能。

当前使用版本：

• IntelliJ 2022.2.3 build #IC-222.4345.14（2022年10月5日构建）
• Scala插件2022.2.17（2022年11月4日构建）

解决方案 #

1. 确认SBT配置的正确性 #

首先确保你的build.sbt已正确定义不同Scala版本对应的源码目录映射，示例配置如下：

lazy val root = (project in file("."))
  .settings(
    scalaVersion := "3.3.1", // 默认使用Scala 3
    crossScalaVersions := Seq("2.13.12", "3.3.1"),
    // 根据Scala版本自动加载对应专属源码目录
    unmanagedSourceDirectories in Compile ++= {
      scalaBinaryVersion.value match {
        case "2.13" => Seq(baseDirectory.value / "src" / "main" / "scala-2")
        case "3" => Seq(baseDirectory.value / "src" / "main" / "scala-3")
        case _ => Seq.empty
      }
    }
  )

该配置是IntelliJ识别目录的基础，SBT能正常运行说明配置无问题，需确保IntelliJ能读取到这些设置。

2. 切换Scala版本并重新索引项目 #

IntelliJ一次只能为项目绑定一个Scala版本，需通过切换版本让IDE识别对应专属目录：

• 打开Project Structure（快捷键Ctrl+Alt+Shift+S）
• 进入Modules，选择项目模块后切换到Dependencies标签页
• 在Scala SDK下拉菜单中选择目标版本（如Scala 2.13），点击Apply
• 等待IDE完成重新索引，此时scala和scala-2目录会被正常识别
• 若需切换到Scala 3，重复上述步骤选择Scala 3 SDK，重新索引后scala和scala-3目录即可启用代码检查、自动补全功能

3. 手动标记源码目录（自动导入失效时） #

如果切换版本后专属目录仍未被识别，可手动标记：

• 在Project视图中右键点击未识别的目录（如scala-3）
• 选择Mark Directory as -> Sources Root
• 注意：切换Scala版本后，可能需要重新标记另一版本的专属目录，因为IntelliJ会根据当前绑定的Scala版本调整目录识别逻辑

4. 更新Scala插件（可选） #

若后续仍遇适配问题，可尝试更新对应IntelliJ版本的Scala插件：

• 打开Settings（快捷键Ctrl+Alt+S）
• 进入Plugins，找到Scala插件后点击Update（如有可用更新）
• 更新完成后重启IDE，重新导入项目

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