Windows 系統安裝 JDK 完整指南與環境變量配置詳解

前言

JDK (Java Development Kit) 是 Java 開發的基石。本文提供從下載、安裝到環境變量配置、驗證的全流程圖文級教程，並針對常見坑點（如路徑含空格、版本衝突）給出避坑指南，助你輕鬆搭建穩定的 Java 開發環境。

第一步：下載適配版本的 JDK

1. 訪問 Oracle 官網下載頁：https://www.oracle.com/java/technologies/downloads/
2. 根據作業系統選擇：Windows x64 Installer（.exe）或 Windows x64 Compressed Archive（.zip，免安裝版）
3. 建議：長期支持版（LTS）如 JDK 17、21，生產環境優先選擇

第二步：執行安裝程式

1. 雙擊 .exe 安裝包，點擊「下一步」
2. 自定義安裝目錄（強烈建議）：
   預設 C:\Program Files\Java\jdk-21\ 含空格，易導致命令行轉義問題。
   推薦改為：D:\Java\jdk-21\ 或 C:\Java\jdk-21\（無空格、無中文、路徑短）
3. 點擊「下一步」完成安裝，記錄實際安裝路徑（JAVA_HOME 將指向此處）

第三步：配置環境變量（核心步驟）

路徑：此電腦 → 右鍵屬性 → 高級系統設置 → 環境變量

1. 新建系統變量 JAVA_HOME

• 變量名：JAVA_HOME
• 變量值：JDK 安裝根目錄（如 D:\Java\jdk-21，不含 bin 目錄）

2. 編輯系統變量 Path

• 選中 Path → 編輯 → 新建
• 添加：%JAVA_HOME%\bin
• 置頂：將其移至列表最頂端（優先於系統自帶的 C:\Windows\System32\ 等路徑，避免系統自帶 java.exe 干擾）

3. （可選）新建 CLASSPATH

現代構建工具（Maven/Gradle）已不強制依賴，但舊項目可能需要：

• 變量名：CLASSPATH
• 變量值：.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar（. 代表當前目錄）

第四步：驗證安裝是否成功

1. 打開新命令提示符（Win+R → cmd → 回車，必須重新打開 才能讀取新環境變量）
2. 輸入以下命令，檢查輸出版本號：

> java -version
java version "21.0.2" 2024-01-16 LTS
Java(TM) SE Runtime Environment (build 21.0.2+13-LTS-58)
Java HotSpot(TM) 64-Bit Server VM (build 21.0.2+13-LTS-58, mixed mode, sharing)

> javac -version
javac 21.0.2

3. 輸入 echo %JAVA_HOME% 確認路徑正確

常見問題與解決方案

進階技巧：多版本共存管理

開發中常需切換 JDK 版本，推薦使用 SDKMAN!（跨平台）或 Scoop（Windows）：

# Scoop 安裝多版本
scoop install openjdk17 openjdk21

# 切換版本
scoop reset openjdk21  # 將 openjdk21 設為當前版本
scoop hold openjdk17   # 鎖定版本防自動更新

或手動修改 JAVA_HOME 指向不同版本目錄，再重啟終端/IDE 即可生效。

總結

規範的 JDK 安裝與環境變量配置是 Java 開發的「地基」。牢記三原則：路徑無空格、JAVA_HOME 指根目錄、Path 置頂 %JAVA_HOME%\bin。配合版本管理工具，輕鬆應對多項目、多版本開發場景。