建置 Java 開發環境

前言

本文將介紹如何建置 Java 開發環境的基本流程。

下載及安裝 JDK

Windows

前往 Adoptium 下載 OpenJDK 的安裝程式。建議選擇 Temurin 25，即 OpenJDK 25。

另一種方式是透過 Chocolatey 安裝。請開啟具有系統管理員權限的終端機，並輸入以下指令：

> choco install openjdk

若未指定版本，通常會安裝最新的穩定版本。若不想頻繁追蹤語法變動，建議選擇 LTS 版本。

macOS

前往 Adoptium 下載 OpenJDK 的安裝程式（PKG 檔）。建議選擇 Temurin 25，即 OpenJDK 25。

另一種方式是透過 Homebrew 安裝，輸入以下指令：

$ brew install openjdk

GNU/Linux

雖然多數主流 GNU/Linux 發行版已內建 OpenJDK 套件，但不一定提供最新版本。因此，這裡建議使用 SDKMAN 安裝 OpenJDK。SDKMAN 是專為 Java 平台設計的套件管理工具，可用於安裝多種 Java 相關開發工具。

使用以下指令安裝 SDKMAN：

$ curl -s "https://get.sdkman.io" | bash

重新啟動終端機後，輸入以下指令安裝 Java：

$ sdk install java

若未指定版本，將會安裝最新的穩定版本。

(選擇性) 安裝 Gradle

Java 本身沒有內建專案管理工具。常見做法是透過 IDE 進行專案管理；若希望避免依賴特定 IDE，則可以使用 Gradle 來管理專案。

Windows

標準作法是前往 Gradle 的官方網站下載壓縮檔，並自行決定安裝位置與設定 PATH 環境變數。

另一種方式是透過 Chocolatey 安裝。請開啟具有系統管理員權限的終端機，並輸入以下指令：

> choco install gradle

即使尚未安裝 Java，Chocolatey 提供的 Gradle 套件也不會強制安裝 Java。使用者可自行選擇適合的 Java 實作版本，因為 Java 實作種類繁多，不適合在 Gradle 套件中強制指定相依性。

macOS

標準作法是前往 Gradle 的官方網站下載壓縮檔，並自行設定安裝位置與 PATH 環境變數。

另一種方式是透過 Homebrew 安裝，輸入以下指令：

$ brew install gradle

Homebrew 的 gradle 套件會相依於 openjdk 套件。

GNU/Linux

多數 GNU/Linux 發行版提供 Gradle 套件，但版本通常較舊。因此，仍建議使用 SDKMAN 安裝最新版 Gradle。請輸入以下指令：

$ sdk install gradle

選擇支援 Java 的 IDE 或編輯器

由於 Java 開發涉及套件與專案管理，VS Code 通常不是最佳選擇。目前較推薦使用 IntelliJ IDEA。雖然此 IDE 較耗記憶體，但整體操作流暢、回應速度佳。若不打算付費，可先使用 Community 版本；日後有進階需求，再升級至 Ultimate 版本。

檢查系統的 Java 版本

使用 java -version（僅一個 hyphen）檢查 Java 執行環境版本，例如：

$ java -version
openjdk version "25.0.2" 2026-01-20 LTS
OpenJDK Runtime Environment Temurin-25.0.2+10 (build 25.0.2+10-LTS)
OpenJDK 64-Bit Server VM Temurin-25.0.2+10 (build 25.0.2+10-LTS, mixed mode, sharing)

使用 javac -version（僅一個 hyphen）檢查 Java 編譯器版本，例如：

$ javac -version
javac 25.0.2

若系統中只有 java 而沒有 javac，代表目前僅安裝 JRE，而非完整的 JDK。請移除 JRE 並重新安裝 JDK。

使用 IntelliJ IDEA Community 版本管理專案

由於 Java 缺乏內建的專案管理工具，使用 IDE 提供的管理功能是一種常見做法。在學習階段，尚不需考慮團隊協作，使用 IDE 管理專案即可。

(選擇性) 使用 Gradle 管理專案

不同開發者的環境可能有所差異。為了提高可攜性與一致性，建議使用不依賴特定 IDE 的專案管理工具。對 Java 而言，Gradle 是常見的選擇。本節示範如何使用 Gradle 建立 Java 專案。

此流程可能會因 Gradle 版本略有差異，重點在理解各選項的意義，而非死記步驟。

建立空目錄：

$ mkdir myapp

將工作目錄（working directory）切換至該目錄：

$ cd myapp

使用 gradle init 初始化專案，並依序回答提示問題：

$ gradle init

選擇專案類型：

Starting a Gradle Daemon (subsequent builds will be faster)

Select type of build to generate:
  1: Application
  2: Library
  3: Gradle plugin
  4: Basic (build structure only)
Enter selection (default: Application) [1..4] 1

此處選擇 Application（應用程式），會建立包含主函式的 driver class。

選擇實作語言：

Select implementation language:
  1: Java
  2: Kotlin
  3: Groovy
  4: Scala
  5: C++
  6: Swift
Enter selection (default: Java) [1..6]

本系列以 Java 為主，故選擇 Java。

Enter target Java version (min: 7, default: 21): 25

選擇建置腳本語言：

Select build script DSL:
  1: Groovy
  2: Kotlin
Enter selection (default: Groovy) [1..2] 1

設定專案名稱：

Project name (default: myapp):

選擇專案結構：

Select application structure:
  1: Single application project
  2: Application and library project
Enter selection (default: Single application project) [1..2]

初學階段不需使用 library，選擇 single application project 即可。

選擇設定檔語言：

Select build script DSL:
  1: Kotlin
  2: Groovy
Enter selection (default: Kotlin)

雖然 Kotlin 近年相當流行，但仍建議使用 Groovy。其語法與 Java 相容性較高，學習門檻較低，且後續亦會接觸 Groovy。

選擇測試框架：

Select test framework:
  1: JUnit 4
  2: TestNG
  3: Spock
  4: JUnit Jupiter
Enter selection (default: JUnit Jupiter) [1..4] 3

在初學階段較少使用測試框架，通常可先選擇 JUnit。若願意使用 Groovy，也可選擇 Spock。

完成設定後，輸入 gradle run 以編譯並執行專案：

$ gradle run

> Task :app:run
Hello World!

BUILD SUCCESSFUL in 7s
2 actionable tasks: 2 executed

若需進一步修改專案設定，需學習 Gradle 的語法。此部分已超出本系列範圍，故不再詳述。