Java 環境變數設置與原理完整解析

前言

正確配置 JAVA_HOME、PATH、CLASSPATH 是 Java 開發環境搭建的第一步。本文詳解各目錄用途、變數設定原理與驗證方法，適用 Windows/Linux/macOS。

一、JDK 安裝目錄結構

jdk1.x.x_xx/
├── bin/          # 執行檔：java, javac, javadoc, jar 等
├── db/           # Java DB (Derby)
├── include/      # JNI 原生開發頭文件
├── jre/          # 獨立 JRE 執行環境
├── lib/          # 核心類庫：tools.jar, dt.jar 等
└── src.zip       # 核心類庫原始碼

關鍵點：bin 下多數命令只是封裝 lib/tools.jar 中的類（如 javac 對應 com.sun.tools.javac.Main）。

二、PATH 環境變數

目的：讓系統在任意目錄下直接執行 java、javac 等命令。

設定值：%JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（Linux/macOS）。

驗證：開啟終端機輸入 javac -version，顯示版本資訊即成功。

三、CLASSPATH 環境變數

現狀：JDK 1.5+ 不再強制要求 設定 CLASSPATH，類載入器會自動載入 lib/tools.jar 等核心包。

若需自訂：

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

• . 代表當前目錄。
• 舊版專案或特殊類載入場景才需手動設定。

四、JAVA_HOME 環境變數

用途：許多框架（Tomcat、Maven、Gradle、IDE）依賴此變數定位 JDK 安裝路徑。

設定值：JDK 安裝根目錄（如 C:\Program Files\Java\jdk-17）。

五、各作業系統設定步驟

Windows

1. 右鍵「此電腦」→「內容」→「進階系統設定」→「環境變數」。
2. 新增系統變數 JAVA_HOME，值為 JDK 路徑。
3. 編輯 Path，新增 %JAVA_HOME%\bin。
4. （選擇性）新增 CLASSPATH。

Linux/macOS (bash/zsh)

# ~/.bashrc 或 ~/.zshrc
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
export PATH=$JAVA_HOME/bin:$PATH
# export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
source ~/.bashrc

六、常見問題排查

• javac: command not found：PATH 未包含 bin 目錄。
• 版本不符：多 JDK 共存時，PATH 順序決定優先級；用 java -version 確認。
• IDE 無法識別 JDK：檢查 IDE 設定中 JDK 路徑是否指向 JAVA_HOME。

七、總結

核心原則：設定 JAVA_HOME，將 %JAVA_HOME%\bin 加入 PATH。CLASSPATH 現代開發幾乎不需手動設定。理解目錄結構與載入機制，能快速定位環境問題。