開始使用

語言

以下說明涵蓋 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

下載並執行 適用於 Windows 的 Scala 安裝程式(基於 Coursier),並依照螢幕上的指示操作。

請依照 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 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。請參閱 JDK 相容性 以取得 Scala/Java 相容性的詳細資料。
  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

您可以在 Scala Book(請 按此 瀏覽 Scala 2 版本)和官方 sbt 文件 中找到更多關於 sbt 的文件

使用 IDE

您可以略過本頁的其餘部分,直接前往 使用 IntelliJ 和 sbt 建立 Scala 專案

開啟 hello-world 專案

我們使用 IDE 開啟專案。最受歡迎的 IDE 是 IntelliJVSCode。它們都提供豐富的 IDE 功能,但您仍然可以使用 許多其他編輯器

使用 IntelliJ

  1. 下載並安裝 IntelliJ Community Edition
  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. hello-world 中執行 cd
  2. 執行 sbt。這會開啟 sbt 主控台。
  3. 輸入 ~run~ 是選用的,它會讓 sbt 在每次儲存檔案時重新執行,這能讓您快速地編輯/執行/偵錯。sbt 也會產生一個 target 目錄,您可以忽略它。

當您完成這個專案的實驗後,請按 [Enter] 中斷 run 指令。然後輸入 exit 或按 [Ctrl+D] 離開 sbt 並回到您的命令提示字元。

後續步驟

完成上述教學課程後,請考慮查看

取得協助

如果您想快速與其他 Scala 使用者建立連線,有許多郵件清單和即時聊天室。請查看我們的 社群 頁面,以取得這些資源的清單,以及如何取得協助。

此頁面的貢獻者