Java 環境變數配置全攻略：Windows/Linux/Mac 通用指南與避坑指南

前言

Java 環境變數配置是開發入門第一關，亦是最容易卡住新手的環節。本文整理跨平台配置標準流程、常見錯誤與驗證方法，助你一次搞定。

核心環境變數說明

Windows 系統配置步驟

1. 下載 JDK 安裝包（Adoptium 或 Oracle）
2. 執行安裝，記住安裝路徑（預設 C:\Program Files\Java\jdk-xx）
3. 右鍵「此電腦」→ 內容 → 進階系統設定 → 環境變數
4. 系統變數區 → 新增：
   • 變數名：JAVA_HOME
   • 變數值：C:\Program Files\Java\jdk-17（實際路徑）
5. 編輯 Path 變數 → 新增：%JAVA_HOME%\bin
6. 可選：新增 CLASSPATH：.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar
7. 確定所有對話框，重新開啟 CMD/PowerShell 生效

Linux/macOS 系統配置

方法一：修改用戶配置檔（推薦，持久化）

# Bash 用戶
vim ~/.bashrc
# Zsh 用戶
vim ~/.zshrc

# 追加以下內容
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
export PATH=$JAVA_HOME/bin:$PATH

# 生效
source ~/.bashrc  # 或 source ~/.zshrc

方法二：系統級配置（需 root）

# /etc/profile.d/java.sh
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
export PATH=$JAVA_HOME/bin:$PATH

# 或編輯 /etc/environment
JAVA_HOME="/usr/lib/jvm/java-17-openjdk"
PATH="$JAVA_HOME/bin:$PATH"

方法三：使用 alternatives 管理多版本（Linux）

# 查看可用版本
update-alternatives --config java

# 手動註冊
sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/java-17/bin/java 100
sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/java-17/bin/javac 100

驗證配置是否成功

# 檢查版本資訊
java -version
javac -version

# 檢查環境變數
echo %JAVA_HOME%      # Windows CMD
echo $JAVA_HOME       # Linux/Mac
Get-ChildItem Env:JAVA_HOME  # PowerShell

預期輸出範例：

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)

常見錯誤與解決方案

1. java: command not found / 'java' 不是內部或外部命令

原因：PATH 未包含 %JAVA_HOME%\bin 或路徑錯誤

解決：檢查 JAVA_HOME 路徑是否存在 bin/java.exe，修正 PATH 順序（建議置頂）

2. 版本不一致

現象：java -version 與 javac -version 版本不同

原因：系統存在多個 JDK，PATH 指向錯誤版本

解決：調整 PATH 順序，或使用 update-alternatives（Linux）切換預設版本

3. Windows 路徑含空格問題

現象：C:\Program Files\Java\jdk-17 空格導致腳本失效

解決：使用短路徑名 C:\Progra~1\Java\jdk-17，或安裝到無空格路徑 C:\Java\jdk-17

4. Linux 圖形介面登入迴圈（Ubuntu 等）

現象：修改 ~/.profile 後無法登入桌面

原因：語法錯誤導致 Shell 初始化失敗

解決：

• Ctrl+Alt+F2 進入 TTY 終端
• 修正配置檔語法
• 或刪除問題配置行

5. 權限不足

現象：Permission denied 執行 java/javac

解決：chmod +x $JAVA_HOME/bin/java（Linux/Mac）

進階技巧

多版本共存管理

• SDKMAN!：sdk install java 17.0.8-tem、sdk use java 11.0.20-tem 輕鬆切換
• jEnv：類似 Python 的 pyenv，專注 Java 版本管理
• Docker：docker run -it eclipse-temurin:17 隔離環境

IDE 整合設定

IntelliJ IDEA：File → Project Structure → SDK 選擇 JAVA_HOME 對應目錄

Eclipse：Window → Preferences → Java → Installed JREs 添加 JDK 路徑

VS Code：安裝 Extension Pack for Java 自動偵測

總結檢查清單

• [ ] JDK 安裝完成並記住路徑
• [ ] JAVA_HOME 指向 JDK 根目錄（含 bin、lib、include）
• [ ] PATH 包含 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（Linux/Mac）
• [ ] 重新開啟終端機驗證 java -version / javac -version
• [ ] IDE 正確識別 JDK 路徑

環境配置雖繁瑣，但遵循標準流程、理解原理，即可避開 90% 的坑。配置完成後，你已準備好踏上 Java 開發之旅！