Java 環境變數 JAVA_HOME、PATH、CLASSPATH 完整配置指南

三大環境變數職責

Windows 配置步驟

1. 右鍵「此電腦」→ 內容 → 進階系統設置 → 環境變數
2. 系統變數區新建/編輯

1. JAVA_HOME

變數名: JAVA_HOME
變數值: C:\Program Files\Java\jdk-17  （你的 JDK 安裝路徑，無 bin）

2. PATH

變數名: Path
變數值: 在現有值末尾追加： %JAVA_HOME%\bin
（用分號 ; 分隔，建議置於最前以優先使用）

3. CLASSPATH

變數名: CLASSPATH
變數值: .;%JAVA_HOME%\lib\tools.jar;%JAVA_HOME%\lib\dt.jar

關鍵細節：

• . 代表當前工作目錄，必須保留
• 用 %JAVA_HOME% 參考變數，未來升級 JDK 只需改一處
• JDK 9+ 模組化後 tools.jar/dt.jar 已移除，此行可省略

Linux/macOS 配置

# ~/.bashrc 或 ~/.zshrc
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=.:$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/dt.jar  # JDK 8 及以下
# JDK 9+ 可省略 CLASSPATH

執行 source ~/.bashrc 生效。

驗證安裝

> java -version
openjdk version "17.0.8" 2023-07-18
OpenJDK Runtime Environment (build 17.0.8+7)
OpenJDK 64-Bit Server VM (build 17.0.8+7, mixed mode, sharing)

> javac -version
javac 17.0.8

> echo %JAVA_HOME%   (Win)
> echo $JAVA_HOME    (Linux/Mac)

常見問題排查

現代開發建議

1. 使用 SDKMAN / Homebrew / Chocolatey 管理多版本 JDK，自動維護環境變數
2. 專案級 JDK 設定：Maven .mvn/jvm.config、Gradle java.toolchain、IDE Project SDK，不依賴全域環境
3. 容器化部署：Dockerfile FROM eclipse-temurin:17-jdk 內建環境，無需手動配置
4. CLASSPATH 可省略：現代構建工具完全接管類路徑，系統 CLASSPATH 反而易造成衝突

總結

JAVA_HOME 是基石，PATH 讓指令生效，CLASSPATH 為舊相容保留。新專案建議：設定 JAVA_HOME + PATH，拋棄系統 CLASSPATH，交給構建工具管理依賴。