前置準備
Windows 10/11 環境變數設定步驟
- 開啟環境變數視窗:
- Win + S 搜尋「編輯系統環境變數」→ 點擊「環境變數」
- 或:右鍵「此電腦」→ 內容 → 進階系統設定 → 環境變數
- 新增系統變數 JAVA_HOME:
- 系統變數區 → 新增 → 變數名:
JAVA_HOME,變數值:C:\Program Files\Eclipse Adoptium\jdk-17.x.x-hotspot(無尾隨反斜線)
- 編輯 Path 變數:
- 系統變數區找到
Path → 編輯 → 新增 → %JAVA_HOME%\bin
- 建議置於列表頂部,優先使用此 JDK
- (可選)新增 CLASSPATH:
- 現代 Java(模組化、Maven/Gradle)通常**不需要**設定 CLASSPATH,留空即可。
- 舊專案需求可設:
.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar
- 驗證:開**新** CMD/PowerShell 視窗
> java -version
openjdk version "17.0.10" 2024-01-16
> javac -version
javac 17.0.10
> echo %JAVA_HOME%
C:\Program Files\Eclipse Adoptium\jdk-17.x.x-hotspot
Linux/macOS 設定(~/.bashrc 或 ~/.zshrc)
export JAVA_HOME=/usr/lib/jvm/temurin-17-jdk-amd64
export PATH=$JAVA_HOME/bin:$PATH
# 生效
source ~/.bashrc
常見坑點與解決
| 現象 | 原因 | 解決 |
java 非內部/外部命令 | Path 未生效或路徑錯誤 | 重開終端機、檢查 %JAVA_HOME%\bin 是否在 Path 最前 |
| 版本不符 | 多 JDK 共存、Path 順序錯誤 | 調整 Path 順序、用 where java 定位實際執行檔 |
| IDE 報找不到 JDK | IDE 讀取註冊表/預設路徑 | IDE 設定中手動指向 JAVA_HOME 目錄 |
| CLASSPATH 導致類衝突 | 舊版 CLASSPATH 汙染 | 刪除系統 CLASSPATH 變數,現代建構工具自動管理 |
進階:多版本管理
- SDKMAN!:
curl -s "https://get.sdkman.io" | bash,sdk install java 21.0.2-tem,sdk use java 17.0.10-tem
- jEnv:Shell 層面切換,配合
export PATH="$HOME/.jenv/shims:$PATH"
- 容器化開發:
docker run -it --rm -v $PWD:/app -w /app eclipse-temurin:17-jdk 專案級隔離