您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 程式設計入門

JDK 環境變量配置精要：JAVA_HOME、Path 與 classpath 真相

編輯：Java 程式設計入門

三個關鍵變量的角色

變量	用途	是否必需 (JDK 9+)	備註
`JAVA_HOME`	指向 JDK 安裝根目錄	✅ 強烈建議	Maven/Gradle/Tomcat/IDE 依賴此變量定位 JDK
`Path`	包含 `%JAVA_HOME%\bin`	✅ 必須	使 `java`、`javac`、`jar` 等命令全局可用
`CLASSPATH`	用戶類搜索路徑	❌ 通常不需要	JDK 1.6+ 自動掃描當前目錄 `.`；建議用 `-cp` 參數顯式指定

為什麼 java 命令不需要配置 Path？

JRE 安裝時會向注冊表 HKLM\SOFTWARE\JavaSoft\Java Runtime Environment 寫入路徑，Windows 會自動在系統 Path 中註冊 java.exe 所在目錄 (通常是 C:\Program Files\Common Files\Oracle\Java\javapath 或 JRE bin)。但 開發需用 JDK 的 javac，因此仍需手動配置 JAVA_HOME 和 %JAVA_HOME%\bin。

標準配置步驟 (圖形界面)

安裝 JDK，記住路徑 (如 C:\Program Files\Java\jdk-17)。
Win + S →「編輯系統環境變量」→「環境變量」。
系統變量 → 新建 → 變量名 JAVA_HOME，值 C:\Program Files\Java\jdk-17。
編輯 Path → 新建 → %JAVA_HOME%\bin → 移至頂部 (優先於 JRE 路徑)。
（可選）刪除舊版 JDK/JRE 路徑避免衝突。
確定保存 → 打開新 CMD → java -version、javac -version 驗證。

常見坑點與排查

『找不到或無法加載主類』：cd 到 .class 所在目錄，或用 -cp 指定類路徑。包結構需匹配目錄層級。
版本不一致：java -version 顯示 1.8，javac -version 顯示 17 → Path 中 JRE 路徑在 JDK 前面，調整順序。
中文路徑/空格：盡量安裝在無空格路徑，或用雙引號包裹變量值。
權限不足：修改系統變量需管理員權限。

Linux/macOS 配置 ( ~/.bashrc / ~/.zshrc )

export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
export PATH=$JAVA_HOME/bin:$PATH
# source ~/.bashrc 生效

多版本管理工具推薦

SDKMAN! (Linux/macOS/WSL)：sdk install java 17.0.8-tem、sdk use java 11.0.20-tem。
jEnv：輕量級版本切換。
Chocolatey / Scoop (Windows)：choco install openjdk17。