深度解析 JAVA_HOME、CLASSPATH、PATH 三大環境變數的角色與設定藝術

一、JAVA_HOME：JDK 安裝根目錄的「別名」

三大核心作用

1. 便利引用： 避免重複輸入長路徑（如 C:\Program Files\Java\jdk1.8.0_202），改用 %JAVA_HOME%
2. 集中維護： JDK 升級/遷移時，只改一處 JAVA_HOME，所有腳本自動生效
3. 生態契約： Maven、Gradle、Tomcat、IDE 等工具約定讀取此變數定位 JDK

設定範例

# Windows
JAVA_HOME=C:\Program Files\Java\jdk1.8.0_202

# Linux/macOS (在 ~/.bashrc 或 /etc/profile)
export JAVA_HOME=/usr/lib/jvm/java-8-openjdk

二、CLASSPATH：類檔案搜尋路徑地圖

核心機制

JVM 啟動時依據 CLASSPATH 尋找 .class 檔案與 .jar 套件。

關鍵規則

• 當前目錄： . 代表當前工作目錄（Java 1.5+ 預設包含，但建議顯式聲明）
• 路徑分隔符： Windows 用 ;，Linux/macOS 用 :
• 目錄 vs JAR： 目錄路徑到包根目錄；JAR 檔路徑直達檔案

設定範例

# Windows
CLASSPATH=.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar;D:\myproject\lib\*

# Linux/macOS
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar:/opt/myapp/lib/*

實戰驗證

# 編譯
javac Hello.java
# 執行（在任何目錄均可）
java Hello

若無 CLASSPATH 或未含 .，執行會拋 NoClassDefFoundError。

三、PATH：讓命令無處不在

必要性

若無 PATH，每次執行需輸入完整路徑：%JAVA_HOME%\bin\java。加入 %JAVA_HOME%\bin 後，任意目錄直接輸入 java、javac、jar 即可。

設定方式

# Windows（在 PATH 變數值最前面新增）
%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;

# Linux/macOS
export PATH=$JAVA_HOME/bin:$JAVA_HOME/jre/bin:$PATH

順序很重要： 放在最前面確保優先使用該 JDK 版本，避免系統預設 Java 干擾。

四、完整設定檢查清單

五、常見坑與避雷指南

1. 路徑含空格： Windows 路徑含空格需加雙引號："C:\Program Files\Java\jdk..."
2. 分號缺失： Windows 多路徑間必須用 ; 分隔，結尾也建議加 ;
3. JRE vs JDK： 僅安裝 JRE 無 javac，開發機必裝 JDK
4. 多版本共存： 靠調整 PATH 順序切換版本，或用 jenv/sdkman 管理
5. CLASSPATH 過長： 優先用 -cp 參數或 Manifest Class-Path，避免汙染全域環境