入门

语言

以下说明涵盖 Scala 2 和 Scala 3。

如果您在设置 Scala 时遇到问题,请随时在 我们 Discord#scala-users 频道中寻求帮助。

面向新手的资源

在您的电脑上安装 Scala

安装 Scala 意味着安装各种命令行工具,例如 Scala 编译器和构建工具。我们建议使用 Scala 安装工具“Coursier”,它会自动安装所有必需的工具,但您仍然可以手动安装每个工具。

Scala 安装程序是一个名为 Coursier 的工具,其主要命令名为 cs。它确保您的系统上安装了 JVM 和标准 Scala 工具。请按照以下说明在您的系统上安装它。

在您的终端中运行以下命令,并按照屏幕上的说明进行操作

brew install coursier/formulas/coursier && cs setup

在 Apple Silicon(M1、M2 等)架构上

curl -fL https://github.com/VirtusLab/coursier-m1/releases/latest/download/cs-aarch64-apple-darwin.gz | gzip -d > cs && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup

否则,在 x86-64 架构上

curl -fL https://github.com/coursier/coursier/releases/latest/download/cs-x86_64-apple-darwin.gz | gzip -d > cs && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup

在您的终端中运行以下命令,并按照屏幕上的说明进行操作。

在 x86-64 架构上

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

否则,在 ARM64 架构上

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

下载并执行 基于 Coursier 的 Windows 版 Scala 安装程序,并按照屏幕上的说明进行操作。

请按照 Coursier 的文档 了解如何安装和运行 cs setup

   您可能需要重新启动终端、注销或重启才能使更改生效。

使用命令 scala -version 检查您的设置,它应该输出

$ scala -version
Scala code runner version 3.4.1 -- Copyright 2002-2022, LAMP/EPFL

除了管理 JVM 之外,cs setup 还安装了有用的命令行工具

命令 描述
scalac Scala 编译器
scala Scala REPL 和脚本运行器
scala-cli Scala CLI,Scala 的交互式工具包
sbtsbtn The sbt 构建工具
amm Ammonite 是一个增强的 REPL
scalafmt Scalafmt 是 Scala 代码格式化工具

有关 cs 的更多信息,请阅读 coursier-cli 文档

cs setup 默认情况下会安装 Scala 3 编译器和运行器(分别为 scalacscala 命令)。无论您打算使用 Scala 2 还是 3,这通常都不是问题,因为大多数项目使用构建工具,该工具将使用正确的 Scala 版本,而与“全局”安装的版本无关。但是,您始终可以使用以下方法启动特定版本的 Scala:

$ cs launch scala:2.13.13
$ cs launch scalac:2.13.13

如果您希望默认情况下运行 Scala 2,则可以强制安装该版本:

$ cs install scala:2.13.13 scalac:2.13.13

…或手动

您只需要两个工具来编译、运行、测试和打包 Scala 项目:Java 8 或 11,以及 sbt。要手动安装它们

  1. 如果您没有安装 Java 8 或 11,请从 Oracle Java 8Oracle Java 11AdoptOpenJDK 8/11 下载 Java。有关 Scala/Java 兼容性详细信息,请参阅 JDK 兼容性
  2. 安装 sbt

使用 sbt 创建“Hello World”项目

安装 sbt 后,您就可以创建 Scala 项目,这将在以下部分中介绍。

要创建项目,您可以使用命令行或 IDE。如果您熟悉命令行,我们建议您使用这种方法。

使用命令行

sbt 是 Scala 的构建工具。sbt 编译、运行和测试您的 Scala 代码。(它还可以发布库并执行许多其他任务。)

要使用 sbt 创建新的 Scala 项目

  1. cd 到一个空文件夹。
  2. 运行命令 sbt new scala/scala3.g8 创建 Scala 3 项目,或运行 sbt new scala/hello-world.g8 创建 Scala 2 项目。这将从 GitHub 拉取项目模板。它还会创建一个 target 文件夹,您可以忽略它。
  3. 出现提示时,将应用程序命名为 hello-world。这将创建一个名为“hello-world”的项目。
  4. 让我们看看刚刚生成了什么
- hello-world
    - project (sbt uses this for its own files)
        - build.properties
    - build.sbt (sbt's build definition file)
    - src
        - main
            - scala (all of your Scala code goes here)
                - Main.scala (Entry point of program) <-- this is all we need for now

有关 sbt 的更多文档,请参阅 Scala 书籍(有关 Scala 2 版本,请参阅 此处)以及官方 sbt 文档

使用 IDE

您可以跳过本页的其余部分,直接转到 使用 IntelliJ 和 sbt 构建 Scala 项目

打开 hello-world 项目

让我们使用 IDE 打开项目。最流行的 IDE 是 IntelliJVSCode。它们都提供丰富的 IDE 功能,但你仍然可以使用 许多其他编辑器

使用 IntelliJ

  1. 下载并安装 IntelliJ 社区版
  2. 按照 安装 IntelliJ 插件的说明 安装 Scala 插件
  3. 打开 build.sbt 文件,然后选择“作为项目打开”

使用 VSCode 和 metals

  1. 下载 VSCode
  2. 市场 安装 Metals 扩展
  3. 接下来,打开包含 build.sbt 文件的目录(如果你按照之前的说明操作,该目录应该是 hello-world)。当系统提示时,选择“导入构建”。

玩转源代码

在你的 IDE 中查看这两个文件

  • build.sbt
  • src/main/scala/Main.scala

当你下一步运行项目时,build.sbt 中的配置将用于运行 src/main/scala/Main.scala 中的代码。

运行 Hello World

如果你习惯使用 IDE,你可以在 IDE 中运行 Main.scala 中的代码。

否则,你可以通过以下步骤从终端运行应用程序

  1. 使用 cd 命令进入 hello-world 目录。
  2. 运行 sbt。这将打开 sbt 控制台。
  3. 输入 ~run~ 是可选的,它会导致 sbt 在每次文件保存时重新运行,从而实现快速的编辑/运行/调试循环。sbt 还将生成一个 target 目录,你可以忽略它。

完成本项目的实验后,请按 [Enter] 键中断 run 命令。然后输入 exit 或按 [Ctrl+D] 退出 sbt 并返回命令行提示符。

下一步

完成以上教程后,请考虑查看

获取帮助

如果您想快速与其他 Scala 用户联系,有很多邮件列表和实时聊天室。查看我们的 社区 页面,了解这些资源的列表以及如何寻求帮助。

本页贡献者