SBT显示的Scala版本与系统不一致的原因及解决办法

问题描述 #

自学Scala和SBT时遇到两个核心问题：

1. 系统已安装Scala 3.2.2，但SBT项目默认使用2.12.17，担心Scala 2与3的不兼容会影响Scala 3代码的编译
2. 想在Ubuntu 22.04系统中彻底移除Scala 2，并让SBT强制使用系统的Scala版本

控制台输出：

della@dell-xps ~/s/l/sbt-testing> scala --version
Scala code runner version 3.2.2 -- Copyright 2002-2023, LAMP/EPFL
della@dell-xps ~/s/l/sbt-testing> scalac --version
Scala compiler version 3.2.2 -- Copyright 2002-2023, LAMP/EPFL
della@dell-xps ~/s/l/sbt-testing> sbt
[info] welcome to sbt 1.8.2 (Ubuntu Java 11.0.17)
[info] loading project definition from /home/della/supply-chain-dev/learning_projects/sbt-testing/project
[info] set current project to sbt-testing (in build file:/home/della/supply-chain-dev/learning_projects/sbt-testing/)
[info] sbt server started at local:///home/della/.sbt/1.0/server/0b33882a8fc31214bc13/sock
[info] started sbt server
sbt:sbt-testing> scalaVersion
[info] 2.12.17
sbt:sbt-testing> ^D
della@dell-xps ~/s/l/sbt-testing> sbt --version
sbt version in this project: 1.8.2
sbt script version: 1.8.2

解决方案 #

一、为什么SBT使用的Scala版本和系统不一致？

SBT项目的Scala版本是独立配置的，默认会匹配当前SBT版本兼容的Scala 2分支（比如sbt 1.8.x默认对应Scala 2.12.x），和系统全局安装的Scala版本没有关联。

二、让SBT项目适配Scala 3的方法

直接修改项目根目录下的build.sbt文件，添加或更新Scala版本配置：

// 指定项目使用的Scala版本为3.2.2
scalaVersion := "3.2.2"
// 可选：启用Scala 3的全部语法特性
scalacOptions ++= Seq("-language:all")

修改后执行sbt compile，SBT会自动下载Scala 3.2.2的编译器及依赖，无需依赖系统安装的Scala。

三、Ubuntu 22.04彻底移除Scala 2的步骤

1. 确认安装方式并卸载
   • 如果是通过APT包管理器安装：

     sudo apt remove --purge scala
     sudo apt autoremove --purge
     

   • 如果是手动解压安装（比如路径为/opt/scala）：

     sudo rm -rf /opt/scala
     

2. 清理环境变量
   打开bash/zsh配置文件（如~/.bashrc或~/.zshrc），删除包含SCALA_HOME、PATH中Scala相关路径的行，保存后执行：

   source ~/.bashrc
   

3. 验证删除结果

   scala --version
   

   输出应仅显示Scala 3.2.2，或提示命令不存在（若仅移除了Scala 2）。

四、关于强制SBT使用系统Scala版本的说明

不推荐强制SBT使用系统Scala版本，因为：

• sbt 1.x系列仅兼容Scala 2.12.x/2.13.x，不支持直接调用系统的Scala 3
• 强行配置会导致SBT启动失败或编译报错

如果仅针对Scala 2需要绑定系统版本，可在build.sbt中添加：

scalaHome := Some(file("/usr/lib/scala")) // 替换为你的系统Scala安装路径
externalIvySettings()

但Scala 3场景下，正确做法仍是直接在build.sbt中指定版本，由SBT自动管理依赖。

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