Scala 安装及环境配置

本章将指导你完成 Scala 开发环境的搭建，包括 JDK、Scala、构建工具和 IDE 的安装配置。

系统要求

在开始之前，确保你的系统满足以下要求：

• 操作系统: Windows 10+、macOS 10.14+、或 Linux
• 内存: 至少 4GB RAM（推荐 8GB+）
• 磁盘空间: 至少 2GB 可用空间
• 网络: 稳定的互联网连接（用于下载依赖）

第一步：安装 Java JDK

Scala 运行在 Java 虚拟机 (JVM) 上，因此首先需要安装 JDK。

检查现有 Java 安装

打开终端或命令提示符，运行：

java -version
javac -version

如果显示 Java 8 或更高版本，可以跳过 JDK 安装。

安装 JDK

方法一：使用 SDKMAN（推荐）

SDKMAN 是管理多个 JDK 版本的优秀工具：

# 安装 SDKMAN
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

# 安装 JDK
sdk install java 17.0.2-open
sdk use java 17.0.2-open

方法二：直接下载安装

1. 访问 OpenJDK 官网 或 Oracle JDK 官网
2. 下载适合你操作系统的 JDK 17 或更高版本
3. 按照安装向导完成安装
4. 配置环境变量 JAVA_HOME

验证 JDK 安装

java -version
# 应该显示类似：
# openjdk version "17.0.2" 2022-01-18

第二步：安装 Scala

方法一：使用 SDKMAN（推荐）

# 安装 Scala
sdk install scala 3.2.2
sdk use scala 3.2.2

# 验证安装
scala -version

方法二：使用 Coursier

Coursier 是 Scala 社区推荐的安装工具：

Linux/macOS:

curl -fL https://github.com/coursier/launchers/raw/master/cs-x86_64-pc-linux.gz | gzip -d > cs
chmod +x cs
./cs setup

Windows:

下载并运行 cs-x86_64-pc-win32.exe

方法三：手动安装

1. 访问 Scala 官网
2. 下载最新的 Scala 发行版
3. 解压到合适的目录
4. 将 bin 目录添加到 PATH 环境变量

验证 Scala 安装

scala -version
# 应该显示类似：
# Scala code runner version 3.2.2

第三步：安装 sbt（Scala Build Tool）

sbt 是 Scala 的标准构建工具。

使用 SDKMAN 安装

sdk install sbt 1.8.2

使用包管理器安装

macOS (Homebrew):

brew install sbt

Ubuntu/Debian:

echo "deb https://repo.scala-sbt.org/scalasbt/debian all main" | 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-get update
sudo apt-get install sbt

Windows:

下载并安装 sbt-1.8.2.msi

验证 sbt 安装

sbt --version
# 应该显示类似：
# sbt version in this project: 1.8.2

第四步：选择和配置 IDE

IntelliJ IDEA（推荐）

IntelliJ IDEA 是 Scala 开发的首选 IDE。

安装步骤：

1. 下载 IntelliJ IDEA Community Edition（免费）
2. 安装并启动 IDEA
3. 安装 Scala 插件：
   • 打开 File → Settings → Plugins
   • 搜索 "Scala" 并安装
   • 重启 IDEA

配置 Scala SDK：

1. 打开 File → Project Structure
2. 选择 Global Libraries
3. 点击 + → Scala SDK
4. 选择已安装的 Scala 版本

Visual Studio Code

VS Code 也是不错的选择，特别适合轻量级开发。

安装步骤：

1. 下载并安装 VS Code
2. 安装 Scala 扩展：
   • 打开扩展面板 (Ctrl+Shift+X)
   • 搜索并安装 "Scala (Metals)"
   • 安装 "Scala Syntax (official)"

Vim/Neovim

对于 Vim 用户，可以使用 coc-metals 插件。

第五步：创建第一个 Scala 项目

使用 sbt 创建项目

# 创建项目目录
mkdir my-first-scala-project
cd my-first-scala-project

# 创建基本的项目结构
mkdir -p src/main/scala
mkdir -p src/test/scala

# 创建 build.sbt 文件
cat > build.sbt << EOF
ThisBuild / version := "0.1.0-SNAPSHOT"
ThisBuild / scalaVersion := "3.2.2"

lazy val root = (project in file("."))
  .settings(
    name := "my-first-scala-project"
  )
EOF

创建 Hello World 程序

# 创建主程序文件
cat > src/main/scala/Main.scala << 'EOF'
@main def hello(): Unit =
  println("Hello, Scala!")
  println("Welcome to the world of functional programming!")
EOF

运行程序

# 编译并运行
sbt run

# 或者进入 sbt shell
sbt
> run
> exit

你应该看到输出：

Hello, Scala!
Welcome to the world of functional programming!

第六步：使用 Scala REPL

Scala REPL（Read-Eval-Print Loop）是学习和实验的好工具。

启动 REPL

scala

在 REPL 中尝试一些代码

scala> val name = "World"
val name: String = World

scala> println(s"Hello, $name!")
Hello, World!

scala> val numbers = List(1, 2, 3, 4, 5)
val numbers: List[Int] = List(1, 2, 3, 4, 5)

scala> val doubled = numbers.map(_ * 2)
val doubled: List[Int] = List(2, 4, 6, 8, 10)

scala> :quit  // 退出 REPL

项目结构说明

标准的 Scala 项目结构如下：

my-scala-project/
├── build.sbt                 # 构建配置文件
├── project/                  # sbt 项目配置
│   ├── build.properties      # sbt 版本
│   └── plugins.sbt           # sbt 插件
├── src/
│   ├── main/
│   │   ├── scala/            # 主要源代码
│   │   └── resources/        # 资源文件
│   └── test/
│       ├── scala/            # 测试代码
│       └── resources/        # 测试资源
├── target/                   # 编译输出（自动生成）
└── lib/                      # 本地依赖库（可选）

常用 sbt 命令

sbt compile      # 编译项目
sbt run          # 运行项目
sbt test         # 运行测试
sbt clean        # 清理编译输出
sbt console      # 启动带项目类路径的 Scala REPL
sbt reload       # 重新加载构建配置
sbt update       # 更新依赖

配置文件示例

build.sbt 详细配置

ThisBuild / version := "0.1.0-SNAPSHOT"
ThisBuild / scalaVersion := "3.2.2"
ThisBuild / organization := "com.example"

lazy val root = (project in file("."))
  .settings(
    name := "my-scala-project",
    
    // 依赖库
    libraryDependencies ++= Seq(
      "org.scalatest" %% "scalatest" % "3.2.15" % Test,
      "org.typelevel" %% "cats-core" % "2.9.0"
    ),
    
    // 编译器选项
    scalacOptions ++= Seq(
      "-deprecation",
      "-feature",
      "-unchecked",
      "-Xfatal-warnings"
    ),
    
    // JVM 选项
    javaOptions ++= Seq(
      "-Xmx2G",
      "-XX:+UseG1GC"
    )
  )

project/build.properties

sbt.version=1.8.2

故障排除

常见问题

1. Java 版本不兼容

错误: Unsupported major.minor version

解决: 确保使用 Java 8 或更高版本

2. sbt 下载依赖慢

解决: 配置国内镜像源

创建 ~/.sbt/repositories 文件：

[repositories]
local
aliyun-central: https://maven.aliyun.com/repository/central
aliyun-public: https://maven.aliyun.com/repository/public
maven-central

3. IDE 无法识别 Scala 代码

解决:

• 确保安装了 Scala 插件
• 检查项目是否正确导入
• 重新导入项目

性能优化

增加 sbt 内存

在项目根目录创建 .sbtopts 文件：

-Xmx2G
-XX:+UseG1GC
-XX:+CMSClassUnloadingEnabled

启用并行编译

在 build.sbt 中添加：

Global / concurrentRestrictions += Tags.limit(Tags.Compile, 4)

验证安装

创建一个测试脚本来验证所有工具是否正确安装：

#!/bin/bash
echo "=== Scala Environment Check ==="

echo "1. Java version:"
java -version

echo -e "\n2. Scala version:"
scala -version

echo -e "\n3. sbt version:"
sbt --version

echo -e "\n4. Creating test project..."
mkdir -p test-scala-env/src/main/scala
cd test-scala-env

cat > build.sbt << 'EOF'
scalaVersion := "3.2.2"
name := "test-env"
EOF

cat > src/main/scala/Test.scala << 'EOF'
@main def test(): Unit =
  println("✅ Scala environment is working correctly!")
EOF

echo "5. Compiling and running test..."
sbt run

cd ..
rm -rf test-scala-env

echo -e "\n🎉 Environment setup complete!"

下一步

现在你已经成功搭建了 Scala 开发环境！接下来我们将学习：

• Scala 基础语法 - 了解 Scala 的基本语法规则
• 如何编写和运行 Scala 程序
• Scala 的核心概念和特性

准备好开始编写 Scala 代码了吗？让我们继续学习！