Scala安装与环境配置 #

一、安装前的准备 #

1.1 系统要求 #

  • 操作系统：Windows、macOS、Linux
  • 内存：建议至少 4GB RAM
  • 磁盘空间：至少 2GB 可用空间

1.2 Java 环境要求 #

Scala 运行在 JVM 上，需要先安装 Java：

bash 
java -version

推荐使用 Java 8 或 Java 11（LTS 版本）。如果未安装 Java：

Windows:

  • 从 Oracle 官网下载 JDK 安装包
  • 或使用 scoop: scoop install openjdk

macOS:

bash 
brew install openjdk@11

Linux (Ubuntu/Debian):

bash 
sudo apt update
sudo apt install openjdk-11-jdk

二、安装 Scala #

2.1 使用 Coursier 安装（推荐） #

Coursier 是 Scala 官方推荐的安装工具：

macOS/Linux:

bash 
curl -fL "https://github.com/coursier/coursier/releases/latest/download/cs-x86_64-pc-linux.gz" | gzip -d > cs && chmod +x cs && ./cs setup

Windows (PowerShell):

powershell 
Invoke-Command -ScriptBlock ([Scriptblock]::Create((Invoke-WebRequest "https://github.com/coursier/coursier/releases/latest/download/cs-x86_64-pc-win32.ps1").Content)) -ArgumentList setup

2.2 使用 SDKMAN 安装（推荐用于 Linux/macOS） #

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

sdk install scala
sdk install sbt

2.3 使用 Homebrew 安装（macOS） #

bash 
brew install scala
brew install sbt

2.4 手动安装 #

  1. 从 Scala 官网下载：https://www.scala-lang.org/download/
  2. 解压到指定目录
  3. 配置环境变量

Linux/macOS 配置：

bash 
export SCALA_HOME=/path/to/scala
export PATH=$SCALA_HOME/bin:$PATH

Windows 配置：

text 
SCALA_HOME=C:\scala
Path=%SCALA_HOME%\bin;%Path%

三、安装 sbt 构建工具 #

sbt 是 Scala 的标准构建工具：

3.1 macOS #

bash 
brew install sbt

3.2 Linux #

bash 
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 update
sudo apt install sbt

3.3 Windows #

powershell 
scoop install sbt

或从官网下载安装包：https://www.scala-sbt.org/download.html

四、验证安装 #

4.1 验证 Scala #

bash 
scala -version

输出示例：

text 
Scala code runner version 3.3.1 -- Copyright 2002-2023, LAMP/EPFL

4.2 验证 sbt #

bash 
sbt --version

4.3 使用 Scala REPL #

bash 
scala
scala 
scala> println("Hello, Scala!")
Hello, Scala!

scala> 1 + 2
res0: Int = 3

scala> :quit

五、IDE 配置 #

5.1 IntelliJ IDEA（推荐） #

  1. 下载 IntelliJ IDEA（Community 或 Ultimate）

  2. 安装 Scala 插件：

    • 打开 Settings/Preferences → Plugins
    • 搜索 “Scala”
    • 点击 Install

  3. 创建 Scala 项目：

    • File → New → Project
    • 选择 Scala
    • 选择 sbt 或 Scala CLI

5.2 VS Code #

  1. 安装 VS Code

  2. 安装 Metals 扩展：

    • 打开 Extensions
    • 搜索 “Scala (Metals)”
    • 点击 Install

  3. 打开 Scala 项目会自动提示导入

5.3 Vim/Neovim #

使用 coc.nvim 或 nvim-lspconfig 配合 Metals：

lua 
require'lspconfig'.metals.setup{}

六、创建第一个项目 #

6.1 使用 sbt 创建项目 #

bash 
mkdir my-first-scala-project
cd my-first-scala-project
sbt new scala/scala3.g8

6.2 项目结构 #

text 
my-first-scala-project/
├── build.sbt              # 构建配置文件
├── project/
│   ├── build.properties   # sbt 版本
│   └── plugins.sbt        # sbt 插件
└── src/
    ├── main/
    │   └── scala/         # 源代码
    └── test/
        └── scala/         # 测试代码

6.3 build.sbt 配置 #

scala 
name := "my-first-scala-project"
version := "0.1.0"
scalaVersion := "3.3.1"

// 添加依赖
libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.17" % Test

6.4 运行项目 #

bash 
sbt run

6.5 运行测试 #

bash 
sbt test

七、Scala 版本选择 #

7.1 Scala 2 vs Scala 3 #

特性 Scala 2.13 Scala 3
语法 传统语法 更简洁的新语法
类型推断 较弱 更强大
隐式转换 implicit given/using
模式匹配 match 增强的模式匹配
生态系统 成熟 快速发展中

7.2 版本选择建议 #

  • 新项目：推荐使用 Scala 3
  • 维护项目：根据现有代码选择
  • 大数据项目：根据 Spark 版本选择

八、常见问题 #

8.1 sbt 下载依赖慢 #

配置国内镜像源，创建 ~/.sbt/repositories：

text 
[repositories]
local
aliyun: https://maven.aliyun.com/repository/public
central: https://repo1.maven.org/maven2/

8.2 内存不足 #

创建 ~/.sbt/jvmopts：

text 
-Xmx4G
-Xms1G
-XX:+UseG1GC

8.3 Scala REPL 中文乱码 #

设置环境变量：

bash 
export JAVA_TOOL_OPTIONS="-Dfile.encoding=UTF-8"

九、总结 #

安装完成后，你已经具备了 Scala 开发环境。接下来让我们编写 第一个 Scala 程序！

最后更新：2026-03-27