Java 環境變量配置圖文教程：JAVA_HOME、Path、CLASSPATH 完整設置指南

正確配置 Java 環境變量是開發、運行 Java 程序的前提。本文提供 Windows 系統下 JDK 安裝驗證、三大核心環境變量（JAVA_HOME、Path、CLASSPATH）逐步配置圖解、驗證方法及常見錯誤排查。

一、 JDK 安裝與驗證

1. 下載 JDK 安裝包（如 jdk-17_windows-x64_bin.exe），雙擊安裝。
2. 安裝路徑建議：D:\Java\jdk-17（無中文、無空格、無特殊符號）。
3. 安裝完成後，打開 CMD 驗證：

   C:\Users> java -version
   java version "17.0.8" 2023-07-18 LTS
   Java(TM) SE Runtime Environment (build 17.0.8+7-LTS-111)
   Java HotSpot(TM) 64-Bit Server VM (build 17.0.8+7-LTS-111, mixed mode, sharing)

✅ 出現版本信息即安裝成功。

二、 環境變量配置入口

右鍵「此電腦」→「屬性」→「高級系統設置」→「環境變量」

或 Win+R 輸入 sysdm.cpl → 高級 → 環境變量

三、 核心變量詳細配置

1. JAVA_HOME (指向 JDK 安裝根目錄)

• 變量名：JAVA_HOME
• 變量值：D:\Java\jdk-17 （你的實際安裝路徑）
• 作用：Maven、Gradle、Tomcat、IDEA 等工具通過此變量定位 JDK。

2. Path (使 java、javac 命令全局可用)

• 在「系統變量」中找到 Path，雙擊編輯（或新建）。
• 點擊「新建」，添加兩條（順序不影響，但建議置頂）：

  %JAVA_HOME%\bin
  %JAVA_HOME%\jre\bin   (JDK 9+ 無 jre 目錄可略過)

• 關鍵：使用 %JAVA_HOME% 變量引用，升級 JDK 時只需改一處。

3. CLASSPATH (類加載路徑，現代項目多由構建工具管理，可選)

• 變量名：CLASSPATH
• 變量值：

  .;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar

• 說明：
  • . 代表當前目錄（必須保留，否則無法運行當前目錄下的類）
  • dt.jar：運行環境類庫
  • tools.jar：編譯工具類庫（javac 依賴）
• 注意：值以 . 開頭，路徑間用 ; 分隔，結尾不加分號。

四、 驗證配置是否生效

重新打開 CMD（舊窗口不會自動刷新環境變量）：

C:\Users> javac
用法: javac <選項> <源文件>
其中, 可能的選項包括:
  -g                         生成所有調試信息
  -g:none                    不生成任何調試信息
  ... (顯示幫助信息即成功)

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

五、 常見錯誤與排查

六、 進階：多版本 JDK 共存管理

推薦使用 SDKMAN! (Linux/Mac/WSL) 或 Jabba / 手動管理多版本：

# 設置當前項目 JDK 版本 (項目級 .sdkmanrc)
sdk use java 17.0.8-tem

# 或在 IDEA 中配置 Project SDK 指向特定版本

環境變量 JAVA_HOME 指向當前主力版本，項目級由構建工具/IDE 接管。

七、 總結

1. 安裝 JDK → 驗證 java -version
2. 設置 JAVA_HOME → JDK 根目錄
3. 編輯 Path → 添加 %JAVA_HOME%\bin
4. 設置 CLASSPATH → .;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar
5. 重開 CMD → 驗證 javac、echo %JAVA_HOME%

配置無誤，Java 開發環境即刻就緒。