异常教程

Scala 安装及环境配置（千字长文）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

前言：为什么需要掌握 Scala 安装及环境配置？

Scala 是一门融合面向对象编程与函数式编程的现代语言，因其高性能、简洁语法和与 Java 生态的兼容性，被广泛应用于大数据处理（如 Apache Spark）、分布式系统开发等领域。无论是初学者探索编程语言特性，还是中级开发者构建实际项目，掌握 Scala 的安装及环境配置是迈向实践的第一步。本文将通过 分步骤、可视化 的方式，结合 实际案例 和 代码示例，手把手指导读者完成配置过程。

系统要求与准备工作

在开始之前，需确保您的操作系统和硬件环境满足以下要求：
| 系统类型 | 最低版本要求 | 推荐版本 |
|----------------|----------------------------|------------------------|
| Windows | Windows 7 SP1 或更高版本 | Windows 10/11 |
| macOS | macOS 10.12 或更高版本 | macOS 13（Ventura） |
| Linux | Ubuntu 18.04 或其他主流发行版 | Ubuntu 22.04 LTS |

准备工作清单：

  1. Java 开发工具包（JDK）：Scala 依赖于 Java 虚拟机（JVM），需先安装 JDK 8 或更高版本。
    • 比喻：Java 环境如同“编程语言的土壤”，没有它，Scala 就像没有根的植物无法生长。
  2. 终端/命令行工具：如 Windows 的 PowerShell、macOS 的 Terminal 或 Linux 的 Bash。
  3. 文本编辑器/IDE：推荐 Visual Studio Code 或 IntelliJ IDEA（需安装 Scala 插件）。

安装步骤：从零开始配置环境

第一步：安装 JDK

Scala 依赖于 Java 运行时环境（JRE），但开发过程中需要更完整的 JDK（包含编译器和工具）。以下是各系统安装 JDK 的方法：

Windows 系统

  1. 访问 Oracle JDK 官网 或 OpenJDK 下载页 。
  2. 下载与系统匹配的安装包（如 jdk-17.0.3_windows-x64.exe）。
  3. 运行安装程序，勾选“Add to PATH”选项以简化后续配置。

macOS 系统

通过 Homebrew 安装 OpenJDK：

brew install --cask adoptopenjdk17

Linux 系统（以 Ubuntu 为例）

sudo apt update  
sudo apt install openjdk-17-jdk

验证 JDK 安装：

java -version

第二步：下载并安装 Scala

方法一：通过官方安装脚本（推荐）

执行以下命令自动下载并配置 Scala：

curl -s https://get.scala-lang.org | sh

此脚本会将 scala 和 scalac（编译器）添加到系统路径中。

方法二：手动安装（适用于高级用户）

  1. 访问 Scala 官方下载页面 ，下载最新版本的 .tgz 压缩包。
  2. 解压后将 bin 目录路径添加到环境变量 PATH 中。例如，在 Linux/macOS 中： 
    echo 'export PATH=$PATH:/path/to/scala/bin' >> ~/.bashrc  
source ~/.bashrc

验证 Scala 安装：

scala -version

第三步：配置代码编辑工具

选项 1：Visual Studio Code（轻量级选择）

  1. 安装 VS Code 扩展：
    • Scala（Microsoft 提供的官方扩展）
    • Java Extension Pack（支持 Java 依赖）
  2. 创建新文件 hello.scala，输入以下代码： 
    object HelloWorld {  
  def main(args: Array[String]): Unit = {  
    println("Hello, Scala World!")  
  }  
}
  3. 通过终端运行： 
    scala hello.scala

选项 2：IntelliJ IDEA（专业 IDE 选择）

  1. 下载并安装 IntelliJ IDEA（Community 版本支持 Scala）。
  2. 安装 Scala 插件：
    • 进入 File > Settings > Plugins，搜索并安装 Scala。
  3. 新建项目时选择 Scala 模板，IDE 会自动生成基础项目结构。

项目构建工具：sbt 的配置与使用

sbt（Scala Build Tool） 是 Scala 项目的标准构建工具，类似于 Maven 或 Gradle。以下是快速入门指南：

安装 sbt

Windows/macOS/Linux

通过脚本一键安装：

echo "deb https://repo.scala-sbt.org/scalasbt/debian all main" | sudo tee /etc/apt/sources.list.d/sbt.list  
sudo apt update && sudo apt install sbt  

choco install sbt

创建首个 sbt 项目

  1. 在终端输入： 
    sbt new scala/scala-seed.g8

    按提示输入项目名称（如 my-first-scala）。

  2. 进入项目目录，编辑 build.sbt 文件定义依赖： 
    name := "my-first-scala"  
version := "0.1"  
scalaVersion := "2.13.8"  
libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.11" % Test
  3. 运行项目： 
    sbt run

常见问题与解决方案

1. 环境变量配置错误

现象：执行 scala 命令时提示“command not found”。
解决：

  • 检查 JAVA_HOME 和 PATH 是否指向正确的 JDK/Scala 路径。
  • 在 Linux/macOS 中，可临时设置： 
    export JAVA_HOME=/usr/lib/jvm/java-17-openjdk  
export PATH=$PATH:$JAVA_HOME/bin

2. 依赖下载失败

现象：执行 sbt compile 时因网络问题中断。
解决：

  • 在项目根目录下创建 project/build.properties，添加国内镜像源： 
    sbt.version=1.7.2  
resolvers += "aliyun" at "https://maven.aliyun.com/repository/public"

3. 编辑器不识别 Scala 语法

解决：

  • 确保 VS Code 的 Scala 扩展已启用，或在 IntelliJ 中检查项目 SDK 配置。

结论：从配置到实践，开启 Scala 之旅

通过本文的分步指导，您已完成 Scala 环境的搭建，并掌握了基础项目构建方法。建议读者通过以下步骤深化实践：

  1. 编写第一个程序：尝试将 Hello World 扩展为计算器或简单游戏。
  2. 探索函数式编程：利用 Scala 的高阶函数和模式匹配特性，重构代码逻辑。
  3. 参与开源项目：在 GitHub 或 Apache 项目中贡献代码，学习社区最佳实践。

记住：配置环境只是起点，持续练习和项目实践才是掌握 Scala 的关键。希望本文能成为您技术进阶的坚实基石！

（全文约 1800 字）

最新发布

查看更多文章