在IntelliJ IDEA中为Maven项目配置导入Scala3 SDK的问题

• Scala插件版本兼容问题
  首先确认你的IntelliJ IDEA版本不低于2021.1，同时Scala插件已升级到最新正式版。2021.1之前的IDEA版本原生不支持Scala 3的SDK识别逻辑，即使手动升级插件也会存在兼容性缺陷，优先使用2022.2及以上版本的IDEA可规避大部分基础兼容问题。
• pom.xml配置不符合IDEA识别规则
  IDEA的Maven Scala SDK自动识别逻辑依赖标准的依赖和插件配置，需检查两处配置：
  1. 移除原有Scala 2.12的scala-library、scala-reflect等Scala 2系列依赖，统一引入Scala 3标准依赖：

  <dependency>
      <groupId>org.scala-lang</groupId>
      <artifactId>scala3-library_3</artifactId>
      <version>3.3.1</version> <!--替换为实际使用的Scala 3版本号-->
  </dependency>
  

  2. 升级scala-maven-plugin到4.6.0及以上版本，且明确指定Scala 3版本：

  <plugin>
      <groupId>net.alchim31.maven</groupId>
      <artifactId>scala-maven-plugin</artifactId>
      <version>4.8.1</version>
      <configuration>
          <scalaVersion>3.3.1</scalaVersion> <!--替换为实际使用的Scala 3版本号-->
      </configuration>
  </plugin>
  

• 手动添加SDK的操作逻辑错误
  不要直接选择Maven仓库中的scala3-library_3构件作为Scala SDK，正确操作步骤如下：
  1. 打开File > Project Structure > Global Libraries，点击+号选择Scala SDK
  2. 在弹出的选择框中，要么选择本地预下载的Scala 3安装路径，要么直接在版本列表中选择对应3系版本，IDEA会自动关联对应的scala3-library_3等标准构件
  3. 进入Modules页面，将你的项目模块的Scala SDK关联为刚才添加的3系SDK，同时移除原有Scala 2.12的SDK关联
• 索引和缓存异常
  若配置无误仍识别失败，按以下步骤重置状态：
  1. 执行mvn clean install确认Maven侧所有依赖拉取、编译正常
  2. 点击IDEA右侧Maven面板的刷新按钮，重新导入所有Maven项目配置
  3. 仍有异常则打开File > Invalidate Caches，勾选清空文件系统缓存和下载的共享索引选项，重启IDEA后重新导入项目即可

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