以下說明涵蓋 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 |
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。請參閱 JDK 相容性 以取得 Scala/Java 相容性的詳細資料。
- 安裝 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
您可以在 Scala Book(請 按此 瀏覽 Scala 2 版本)和官方 sbt 文件 中找到更多關於 sbt 的文件
使用 IDE
您可以略過本頁的其餘部分,直接前往 使用 IntelliJ 和 sbt 建立 Scala 專案
開啟 hello-world 專案
我們使用 IDE 開啟專案。最受歡迎的 IDE 是 IntelliJ 和 VSCode。它們都提供豐富的 IDE 功能,但您仍然可以使用 許多其他編輯器。
使用 IntelliJ
- 下載並安裝 IntelliJ Community Edition
- 按照如何安裝 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 中的程式碼。
否則,您可以使用以下步驟從終端機執行應用程式
- 在
hello-world
中執行cd
。 - 執行
sbt
。這會開啟 sbt 主控台。 - 輸入
~run
。~
是選用的,它會讓 sbt 在每次儲存檔案時重新執行,這能讓您快速地編輯/執行/偵錯。sbt 也會產生一個target
目錄,您可以忽略它。
當您完成這個專案的實驗後,請按 [Enter]
中斷 run
指令。然後輸入 exit
或按 [Ctrl+D]
離開 sbt 並回到您的命令提示字元。
後續步驟
完成上述教學課程後,請考慮查看
- Scala 書籍(請在此處查看 Scala 2 版本),它提供了一系列簡短的課程,介紹 Scala 的主要功能。
- Scala 導覽,了解 Scala 功能的精簡介紹。
- 學習資源,其中包括線上互動教學課程。
- 我們列出了一些流行的 Scala 書籍.
- 移轉指南可協助您將現有的 Scala 2 程式碼庫移轉到 Scala 3。
取得協助
如果您想快速與其他 Scala 使用者建立連線,有許多郵件清單和即時聊天室。請查看我們的 社群 頁面,以取得這些資源的清單,以及如何取得協助。