Scala 安装及环境配置（快速上手）

Scala 安装及环境配置：从零开始搭建你的开发环境

你是否在学习函数式编程时，被 Scala 这个名字吸引？它融合了面向对象与函数式编程的精髓，运行在 JVM 上，兼容 Java 生态，是构建高并发、高可维护系统的重要选择。但对很多初学者来说，第一步总是卡在“如何安装和配置环境”上。别担心，这篇文章会带你一步步完成 Scala 安装及环境配置，不绕弯子，不堆概念，只讲实操。

我们以最常见、最稳定的开发场景为例：在 Mac OS 和 Linux 系统上使用 Homebrew 或包管理器安装 Scala，再配合 sbt 构建工具，完成一个完整的开发环境搭建。整个过程不会超过 15 分钟，但能让你真正迈入 Scala 世界的大门。

选择合适的 Scala 版本

Scala 语言发展迅速，目前主流版本是 Scala 2.13.x 和 Scala 3.x。对于初学者，推荐从 Scala 2.13.10 开始，因为它的生态最成熟，文档丰富，社区支持强大。而 Scala 3 虽然语法更优雅，但部分库尚未完全迁移，适合进阶开发者尝试。

⚠️ 小贴士：就像选车一样，新手建议先开一辆“燃油车”（Scala 2），熟悉后再换“新能源”（Scala 3）。不要一开始就追求最新版，容易踩坑。

安装 JDK：Scala 的“地基”

Scala 运行在 JVM（Java 虚拟机）之上，所以第一步必须安装 JDK。目前推荐使用 OpenJDK 8 或 OpenJDK 11。其中 OpenJDK 8 是最稳定的版本，兼容性最好。

在 macOS 上安装 JDK

使用 Homebrew 安装 OpenJDK 11：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

brew install openjdk@11

注释：brew install openjdk@11 是 Homebrew 的标准命令，会自动下载并配置 JDK 11。安装完成后，系统会将 java 命令指向 OpenJDK 11。

在 Linux（Ubuntu）上安装 JDK

sudo apt update

sudo apt install openjdk-11-jdk -y

注释：-y 参数表示自动确认安装，避免交互式输入。安装完成后，可通过 java -version 验证是否成功。

安装 Scala 编译器

现在我们来安装 Scala 编译器。Scala 官方提供了 scala 命令行工具，用于编译和运行 Scala 程序。

使用 Homebrew 安装（macOS）

brew install scala

注释：Homebrew 会自动下载并配置 Scala 环境变量，无需手动设置 PATH。安装后可通过 scala -version 检查版本。

使用包管理器安装（Linux）

sudo apt install scala -y

注释：部分 Linux 发行版可能需要先添加 Scala 官方仓库。如果安装失败，请参考官方文档添加源。

验证安装结果

安装完成后，必须验证环境是否配置成功。这是避免后续“代码跑不起来”的关键一步。

java -version

scala -version

预期输出示例：

openjdk version "11.0.20" 2023-07-18 LTS
OpenJDK Runtime Environment Corretto-11.0.20.8.1 (build 11.0.20+8-LTS-194)
OpenJDK 64-Bit Server VM Corretto-11.0.20.8.1 (build 11.0.20+8-LTS-194, mixed mode)

Scala version 2.13.10

✅ 成功标志：java -version 显示 JDK 版本，scala -version 显示 Scala 版本。如果出现 command not found，说明环境变量未配置，需手动处理。

配置环境变量（必要步骤）

如果你在安装后运行 scala 命令报错，多半是因为环境变量未正确设置。

手动配置 PATH（macOS/Linux）

打开终端，编辑 shell 配置文件：

nano ~/.zshrc

nano ~/.bashrc

在文件末尾添加以下内容（路径可能因安装方式不同而异）：

export PATH="/usr/local/bin:$PATH"
export PATH="/opt/homebrew/bin:$PATH"  # Homebrew 路径（macOS Apple Silicon）
export PATH="$HOME/.local/bin:$PATH"   # 用户级安装路径

注释：export PATH=... 用于将 Scala 的可执行文件目录加入系统搜索路径。不同系统路径不同，请根据实际情况调整。常见的路径包括 /usr/local/bin、/opt/homebrew/bin、~/bin 等。

保存后，执行：

source ~/.zshrc   # macOS zsh 用户
source ~/.bashrc  # Linux bash 用户

然后再次运行 scala -version，应该就能正常显示版本了。

安装 sbt：构建工具，项目管理的“指挥官”

sbt（Scala Build Tool）是 Scala 项目构建的标配工具。它能自动下载依赖、编译代码、运行测试、打包发布，相当于 Java 世界的 Maven 或 Gradle。

安装 sbt（macOS）

brew install sbt

安装 sbt（Linux）

echo "deb https://repo.scala-sbt.org/scalasbt/debian all main" | sudo tee /etc/apt/sources.list.d/sbt.list
echo "deb https://repo.scala-sbt.org/scalasbt/debian /" | sudo tee /etc/apt/sources.list.d/sbt.list
curl -sL "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x2EE0EA64E40A89B84B2DF73499E82A75642AC823" | sudo apt-key add
sudo apt update
sudo apt install sbt -y

注释：sbt 的安装需要添加官方仓库，否则 apt 无法找到最新版本。添加密钥是为了验证包来源的安全性。

创建第一个 Scala 项目：Hello World

现在我们来创建一个真正的 Scala 项目，验证整个环境是否可用。

mkdir hello-scala
cd hello-scala

sbt new scala/scala-seed.g8

注释：sbt new 是 sbt 的项目模板命令。scala/scala-seed.g8 是官方推荐的最小项目模板，包含 src/main/scala 目录和 build.sbt 配置文件。

运行后，sbt 会提示你输入项目名称、组织名等信息。例如：

name [hello-scala]: MyFirstScalaApp
organization [com.example]: com.mycompany
scala_version [2.13.10]: 2.13.10

输入完成后，sbt 会自动生成项目结构。

编写并运行 Scala 代码

进入项目目录，打开 src/main/scala/App.scala 文件：

// App.scala
object App extends App {
  // 打印一行欢迎语
  println("欢迎来到 Scala 世界！")

  // 定义一个变量，使用 val（不可变）
  val name = "小明"
  val age = 25

  // 使用字符串插值输出
  println(s"我叫 $name，今年 $age 岁。")

  // 演示函数式编程：定义一个函数，接收两个整数，返回和
  def add(x: Int, y: Int): Int = {
    x + y
  }

  // 调用函数并打印结果
  val result = add(10, 20)
  println(s"10 + 20 = $result")
}

注释：

object App extends App 是 Scala 程序的入口点，类似 Java 的 public static void main。

val 定义不可变变量，var 定义可变变量（不推荐初学者使用）。

s"..." 是字符串插值，类似 Python 的 f-string，可直接嵌入变量。

def add 是函数定义，Int 表示参数和返回值类型。

编译与运行项目

在项目根目录下执行：

sbt compile

sbt run

预期输出：

[info] compiling 1 Scala source to /Users/xxx/hello-scala/target/scala-2.13/classes ...
[success] Total time: 3 s, completed Apr 5, 2025 10:00:00 AM
[info] running App 
欢迎来到 Scala 世界！
我叫 小明，今年 25 岁。
10 + 20 = 30

✅ 成功标志：看到 running App 和预期的输出内容。这说明你的 Scala 安装及环境配置完全成功！

常见问题排查

问题	可能原因	解决方案
`scala: command not found`	环境变量未配置	检查 `PATH` 是否包含 Scala 安装路径，使用 `which scala` 查看
`sbt: command not found`	sbt 未安装或 PATH 未更新	重新安装 sbt，或手动添加 `~/.local/bin` 到 PATH
`Java version mismatch`	JDK 版本不兼容	安装 OpenJDK 8 或 11，避免使用 JDK 17+ 早期版本
`sbt run` 报错依赖下载失败	网络问题或仓库配置错误	检查网络，或更换为阿里云镜像源

总结

通过本文，你已经完成了 Scala 安装及环境配置的全流程：从安装 JDK、Scala 编译器，到配置环境变量，再到使用 sbt 创建项目并运行第一个 Scala 程序。整个过程不依赖图形界面，完全通过命令行完成，是真正面向开发者的实践路径。

记住，环境配置是编程的第一步，就像盖房子要先打地基。虽然看起来琐碎，但一旦搞定，后续的学习和开发将无比顺畅。

现在，你已经站在了 Scala 世界的门口。接下来，可以尝试学习函数式编程的核心概念：高阶函数、不可变数据、模式匹配，甚至探索 Akka 框架构建分布式系统。

别忘了，编程不是一蹴而就的事，但每一步都算数。从今天开始，让 Scala 成为你技术栈中的一把利器。