新電腦搭建 Java 開發環境完整指南 (JDK + Eclipse)

面向 Java 初學者，詳細記錄在全新 Windows 電腦上搭建 Java 開發環境的完整步驟：JRE/JDK 安裝、環境變量配置、Eclipse IDE 安裝啟動、常見問題排查。

第一步：下載並安裝 JDK (包含 JRE)

1.1 官方下載地址

• Oracle JDK：https://www.oracle.com/java/technologies/downloads/ (需登錄 Oracle 帳號)
• OpenJDK (免費、開源)：https://adoptium.net/ (推薦 Temurin 版本)
• 其他發布版：Amazon Corretto、Azul Zulu、Microsoft Build of OpenJDK

1.2 選擇版本建議

新手建議：下載 Java 17 或 21 LTS 版本，長期支援且特性豐富。

1.3 判斷系統位數

# 命令提示符執行
systeminfo | findstr /C:"System Type"
# x64-based PC = 64位
# x86-based PC = 32位

現代電腦絕大多數為 64 位，下載 x64 或 amd64 版本。

1.4 安裝步驟

1. 雙擊安裝包 (如 jdk-17_windows-x64_bin.exe 或 .msi)
2. 安裝路徑建議：C:\Java\jdk-17 (避免空格、中文、Program Files 權限問題)
3. 選擇「開發工具」完整安裝
4. 完成安裝

第二步：配置環境變量 (關鍵步驟)

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

2.1 新建系統變量 JAVA_HOME

• 變量名：JAVA_HOME
• 變量值：C:\Java\jdk-17 (你的實際安裝路徑)

2.2 編輯系統變量 Path

• 找到 Path (或 PATH)，雙擊編輯
• 點擊「新建」，添加兩行：
  %JAVA_HOME%\bin
%JAVA_HOME%\jre\bin (JDK 11+ 無獨立 jre 目錄，此行可省略)
• 確保在列表較前位置 (優先於系統路徑)

2.3 新建系統變量 CLASSPATH (可選，現代 Java 通常不需要)

• 變量名：CLASSPATH
• 變量值：.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar
• 注意：開頭的 . 代表當前目錄，不可省略

2.4 驗證配置

打開新的命令提示符 (舊窗口不生效)：

C:\> java -version
java version "17.0.x" ...
Java(TM) SE Runtime Environment ...
Java HotSpot(TM) 64-Bit Server VM ...

C:\> javac -version
javac 17.0.x

C:\> echo %JAVA_HOME%
C:\Java\jdk-17

三條命令均正常輸出版本信息，即配置成功。

第三步：下載並安裝 Eclipse IDE

3.1 官網下載

• 官網：https://www.eclipse.org/downloads/
• 直接下載頁：https://www.eclipse.org/downloads/packages/

3.2 選擇套件

選擇對應系統位數 (Windows x86_64)。

3.3 下載鏈接選擇

頁面底部選擇鏡像站，國內推薦：

• 清華大學鏡像
• 中科大鏡像
• 華為雲鏡像

3.4 解壓並啟動

1. 解壓到純英文路徑：D:\Dev\eclipse (無中文、無空格)
2. 進入目錄，雙擊 eclipse.exe 啟動
3. 首次啟動選擇工作空間：D:\Dev\workspace (建議純英文路徑)
4. 勾選「Use this as the default and do not ask again」

3.5 關鍵配置：指定 JDK (eclipse.ini)

編輯 eclipse.ini (安裝目錄下)，在 -vmargs 之前添加：

-vm
C:/Java/jdk-17/bin/javaw.exe

注意：

• -vm 和路徑佔兩行
• 路徑用正斜槠 / 或雙反斜槠 \\
• 必須指向 javaw.exe (非 java.exe)
• 此配置確保 Eclipse 自身運行在指定 JDK 上，避免版本衝突

第四步：創建第一個 Java 項目驗證

1. File → New → Java Project
2. Project name: HelloWorld
3. JRE: 選擇配置好的 JDK 17
4. Finish
5. 右鍵 src → New → Class，Name: HelloWorld，勾選 public static void main
6. 輸入代碼：

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, Java World!");
    }
}

7. 右鍵編輯器 → Run As → Java Application
8. Console 輸出 Hello, Java World! 即成功

常見問題排查表

進階推薦配置

• 編碼統一：Window → Preferences → General → Workspace → Text file encoding: UTF-8
• 自動導入：Java → Editor → Save Actions → Organize imports
• 代碼格式化：Java → Code Style → Formatter 導入團隊統一風格
• 常用插件：Eclipse Marketplace 安裝 Lombok、MyBatis、CheckStyle、Git (EGit 內建)
• 內存調優：eclipse.ini 調整 -Xms512m -Xmx2g 根據機器內存

替代方案：IntelliJ IDEA

目前業界主流 IDE，社區版免費：

• 下載：https://www.jetbrains.com/idea/download/
• 安裝引導式，自動檢測 JDK，開箱即用
• 智能提示、重構、調試體驗優於 Eclipse

總結

1. 安裝 JDK (推薦 Java 17/21 LTS) 到純英文路徑
2. 配置 JAVA_HOME、Path 環境變量
3. 驗證 java -version / javac -version
4. 下載 Eclipse (Enterprise 版) 解壓到純英文路徑
5. 配置 eclipse.ini 指定 -vm 為 JDK 的 javaw.exe
6. 創建測試專案驗證環境

完成以上步驟，你的 Java 開發環境就搭建完成了！祝編程愉快！