以下说明涵盖 Scala 2 和 Scala 3。
如果您在设置 Scala 时遇到问题,请随时在 我们 Discord 的 #scala-users
频道中寻求帮助。
面向新手的资源
在您的电脑上安装 Scala
安装 Scala 意味着安装各种命令行工具,例如 Scala 编译器和构建工具。我们建议使用 Scala 安装工具“Coursier”,它会自动安装所有必需的工具,但您仍然可以手动安装每个工具。
使用 Scala 安装程序(推荐方式)
Scala 安装程序是一个名为 Coursier 的工具,其主要命令名为 cs
。它确保您的系统上安装了 JVM 和标准 Scala 工具。请按照以下说明在您的系统上安装它。
您可能需要重新启动终端、注销或重启才能使更改生效。
使用命令 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 的交互式工具包 |
sbt ,sbtn |
The sbt 构建工具 |
amm |
Ammonite 是一个增强的 REPL |
scalafmt |
Scalafmt 是 Scala 代码格式化工具 |
有关 cs
的更多信息,请阅读 coursier-cli 文档。
cs setup
默认情况下会安装 Scala 3 编译器和运行器(分别为scalac
和scala
命令)。无论您打算使用 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。要手动安装它们
- 如果您没有安装 Java 8 或 11,请从 Oracle Java 8、Oracle Java 11 或 AdoptOpenJDK 8/11 下载 Java。有关 Scala/Java 兼容性详细信息,请参阅 JDK 兼容性。
- 安装 sbt
使用 sbt 创建“Hello World”项目
安装 sbt 后,您就可以创建 Scala 项目,这将在以下部分中介绍。
要创建项目,您可以使用命令行或 IDE。如果您熟悉命令行,我们建议您使用这种方法。
使用命令行
sbt 是 Scala 的构建工具。sbt 编译、运行和测试您的 Scala 代码。(它还可以发布库并执行许多其他任务。)
要使用 sbt 创建新的 Scala 项目
cd
到一个空文件夹。- 运行命令
sbt new scala/scala3.g8
创建 Scala 3 项目,或运行sbt new scala/hello-world.g8
创建 Scala 2 项目。这将从 GitHub 拉取项目模板。它还会创建一个target
文件夹,您可以忽略它。 - 出现提示时,将应用程序命名为
hello-world
。这将创建一个名为“hello-world”的项目。 - 让我们看看刚刚生成了什么
- 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 是 IntelliJ 和 VSCode。它们都提供丰富的 IDE 功能,但你仍然可以使用 许多其他编辑器。
使用 IntelliJ
- 下载并安装 IntelliJ 社区版
- 按照 安装 IntelliJ 插件的说明 安装 Scala 插件
- 打开
build.sbt
文件,然后选择“作为项目打开”
使用 VSCode 和 metals
- 下载 VSCode
- 从 市场 安装 Metals 扩展
- 接下来,打开包含
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 中的代码。
否则,你可以通过以下步骤从终端运行应用程序
- 使用
cd
命令进入hello-world
目录。 - 运行
sbt
。这将打开 sbt 控制台。 - 输入
~run
。~
是可选的,它会导致 sbt 在每次文件保存时重新运行,从而实现快速的编辑/运行/调试循环。sbt 还将生成一个target
目录,你可以忽略它。
完成本项目的实验后,请按 [Enter]
键中断 run
命令。然后输入 exit
或按 [Ctrl+D]
退出 sbt 并返回命令行提示符。
下一步
完成以上教程后,请考虑查看
- Scala 书籍(查看 Scala 2 版本 此处),它提供了一组简短的课程,介绍了 Scala 的主要功能。
- Scala 导览,提供对 Scala 功能的简要介绍。
- 学习资源,其中包括在线互动教程和课程。
- 我们的一些热门 Scala 书籍列表.
- 迁移指南 可帮助您将现有的 Scala 2 代码库迁移到 Scala 3。
获取帮助
如果您想快速与其他 Scala 用户联系,有很多邮件列表和实时聊天室。查看我们的 社区 页面,了解这些资源的列表以及如何寻求帮助。