Windows 設定 Java 環境變數 (JAVA_HOME、Path、CLASSPATH) 完整圖解

前言

正確設定 Java 環境變數是開發、執行 Java 程式、部署 Tomcat、啟動 Eclipse/IntelliJ 的前提。本文以 Windows 10/11 為例，詳細說明三大變數的作用、設定值與驗證步驟。

三大核心變數

逐步設定教學

1. 安裝 JDK，記住安裝路徑 (如 D:\Java\jdk-21)
2. Win+S 搜尋「編輯系統環境變數」→ 環境變數
3. 系統變數區點選「新增」或「編輯」：

1. JAVA_HOME

變數名：JAVA_HOME
變數值：D:\Java\jdk-21

2. Path

選中 Path → 編輯 → 新增 → 輸入：

%JAVA_HOME%\bin

移至最上方優先搜尋 (避免系統自帶舊版 java.exe 干擾)。

3. CLASSPATH (可選)

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

. 代表當前目錄；dt.jar 包含運行環境類，tools.jar 包含編譯工具類。現代建構工具 (Maven/Gradle) 會自動管理依賴，通常不需手動設定 CLASSPATH。

驗證設定

開啟**新的** CMD (舊視窗不會生效)：

C:\Users> java -version
java version "21.0.2" 2024-01-16 LTS
Java(TM) SE Runtime Environment (build 21.0.2+13-LTS-58)
Java HotSpot(TM) 64-Bit Server VM (build 21.0.2+13-LTS-58, mixed mode, sharing)

C:\Users> javac -version
javac 21.0.2

C:\Users> echo %JAVA_HOME%
D:\Java\jdk-21

全部正常顯示即設定成功！

常見坑點與解決

• 空格路徑：安裝路徑含空格 (Program Files) 會導致部分腳本失敗，建議安裝到無空格路徑 (如 D:\Java\jdk-21) 或用雙引號包裹
• 多版本衝突：Path 中舊版 JDK 路徑在前，導致 java -version 不符預期 → 調整順序或移除舊路徑
• CLASSPATH 導致類衝突：手動設定 CLASSPATH 可能干擾 Maven/Gradle 專案，**建議留空或刪除**
• 管理員權限：修改系統變數需管理員權限，用戶變數僅對當前用戶生效

進階：專案級別環境隔離

開發多專案時，避免全域環境變數污染，推薦使用：

• jEnv / SDKMAN!：命令列切換 JDK 版本
• Maven/Gradle Wrapper：專案自帶建構工具版本
• IDE 內建 JDK 管理：IntelliJ/Eclipse 可為每個專案指定 SDK
• Docker：容器化鎖定完整執行環境

總結

核心只需兩步：設定 JAVA_HOME 指向 JDK 根目錄、將 %JAVA_HOME%\bin 加入 Path。CLASSPATH 現代開發幾乎不需手動設定。養成「新開 CMD 驗證」習慣，能省去無數環境疑難雜症。