您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

Windows/Linux/macOS 下 Java 環境變量配置圖文教程（JAVA_HOME、PATH、CLASSPATH）

編輯：Java 相關知識

為什麼要配置環境變量？

安裝 JDK 後，操作系統不知道 java、javac 等命令在哪裡。配置環境讓系統能在任意目錄下直接運行 Java 命令，也是 IDE、構建工具（Maven/Gradle）正常工作的前提。

三大核心變量

變量名	作用	典型值
JAVA_HOME	JDK 安裝根目錄，其他工具引用的基準	C:\Program Files\Java\jdk-17 / /usr/lib/jvm/java-17-openjdk
PATH	系統搜索可執行文件的路徑列表，需包含 `%JAVA_HOME%\bin`	...;%JAVA_HOME%\bin
CLASSPATH	類搜索路徑（現代 Java 通常不需要手動設置）	.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar (舊版建議)

Windows 10/11 圖文步驟

右鍵「此電腦」→「屬性」→「高級系統設置」→「環境變量」
新建系統變量 JAVA_HOME：變量值填 JDK 安裝路徑（如 C:\Program Files\Java\jdk-17），**建議路徑末尾不加反斜杠**。
編輯 Path 變量：新增 %JAVA_HOME%\bin，移至頂部優先級最高。
（可選）新建 CLASSPATH：.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar。注意： JDK 9+ 模組化後，tools.jar 已不存在，**強烈建議留空或刪除此變量**，避免干擾模塊系統。

Linux/macOS 永久生效配置

編輯 ~/.bashrc、~/.zshrc 或 /etc/profile（全局）：

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 生效。

驗證配置

$ java -version
openjdk version "17.0.8" 2023-07-18
OpenJDK Runtime Environment (build 17.0.8+7)
OpenJDK 64-Bit Server VM (build 17.0.8+7, mixed mode, sharing)

$ javac -version
javac 17.0.8

$ echo $JAVA_HOME
/usr/lib/jvm/java-17-openjdk

常見坑點避雷

路徑含空格/中文： Windows 安裝路徑盡量避免空格（如 Program Files），或使用短路徑 Progra~1。
多版本衝突： Path 中較早出現的 java.exe 生效，用 where java (Win) / which -a java (Linux) 排查。
CLASSPATH 導致類加載異常： 刪除或留空 CLASSPATH，讓類加載器按模塊/模塊路徑工作。
管理員權限： 修改系統變量需管理員權限，用戶變量無需。

進階：多版本切換工具

Windows： ojdkbuild + 手動修改 JAVA_HOME，或使用 SDKMAN! (需 WSL/MinGW)。
Linux/macOS： SDKMAN! 一鍵安裝/切換多版本 JDK：sdk install java 17.0.8-tem、sdk use java 11.0.20-tem。
Docker： 容器化項目直接指定基礎鏡像 eclipse-temurin:17-jdk，無需宿主機配置。