Eclipse for Java EE 開發環境搭建完整指南（Windows 10 示例）

本文記錄從零開始搭建 Eclipse for Java EE 開發環境的完整流程，涵蓋 JDK 安裝、環境變數配置、Eclipse 解壓啟動、Tomcat 整合、動態 Web 專案建立與 Servlet 測試，適合初學者快速落地，也可作為團隊環境標準化參考。

一、軟體下載與版本選擇建議

二、JDK 安裝與環境變數配置（關鍵步驟）

1. 執行安裝程式

• 雙擊 jdk-8uXXX-windows-x64.exe（或對應版本）。
• 安裝路徑建議無空格、無中文，例如 C:\Java\jdk1.8.0_361。
• 勾選 Public JRE（可選），完成安裝。

2. 設定系統環境變數（Win10/11 通用）

1. 右鍵「此電腦」→「屬性」→「進階系統設定」→「環境變數」。
2. 系統變數區域 → 「新增」：
   • 變數名：JAVA_HOME
   • 變數值：C:\Java\jdk1.8.0_361（你的實際安裝路徑）
3. 編輯 Path 變數 → 「新增」兩條：
   • %JAVA_HOME%\bin
   • %JAVA_HOME%\jre\bin（若安裝了 Public JRE）
4. 新增/編輯 CLASSPATH（可選，現代專案多用 Maven/Gradle 管理依賴，不強制）：
   • 值：.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar
5. 全部「確定」關閉對話框。

3. 驗證安裝

C:\Users\Admin> java -version
java version "1.8.0_361"
Java(TM) SE Runtime Environment (build 1.8.0_361-b09)
Java HotSpot(TM) 64-Bit Server VM (build 25.361-b09, mixed mode)

C:\Users\Admin> javac -version
javac 1.8.0_361

三、Eclipse 解壓與啟動

1. 下載 eclipse-enterprise-2023-09-R-win32-x86_64.zip（免安裝綠色版）。
2. 解壓至無空格、無中文路徑，例如 D:\DevTools\eclipse-enterprise。
3. 先確保 JDK 已配置好，否則雙擊 eclipse.exe 會彈窗「A Java Runtime Environment (JRE) or Java Development Kit (JDK) must be available...」。
4. 首次啟動會提示選擇 Workspace 工作空間，建議路徑無空格、無中文，如 D:\Workspace\jee，勾選「Use this as default...」避免每次詢問。

若啟動報錯「Failed to create the Java Virtual Machine」

編輯解壓目錄下 eclipse.ini，在 -vmargs 之前指定 JDK 路徑：

-vm
C:/Java/jdk1.8.0_361/bin/javaw.exe
-vmargs
-Dosgi.requiredJavaVersion=1.8
-Xms256m
-Xmx2048m
--add-modules=ALL-SYSTEM

四、Tomcat 解壓與獨立驗證

1. 下載 apache-tomcat-9.0.83-windows-x64.zip，解壓至 D:\DevTools\apache-tomcat-9.0.83。
2. 進入 bin 目錄，雙擊 startup.bat，觀察控制台輸出 Server startup in [xxx] ms。
3. 瀏覽器訪問 https://localhost:8080，出現 Tomcat 貓首頁即成功。
4. 關閉：bin/shutdown.bat 或 Ctrl+C 控制台。

五、Eclipse 整合 Tomcat（Server Runtime Environment）

1. Eclipse 選單：Window → Preferences → Server → Runtime Environments。
2. 點「Add...」→ 選擇 Apache Tomcat v9.0 → Next。
3. Tomcat installation directory：瀏覽選擇 D:\DevTools\apache-tomcat-9.0.83。
4. JRE：選擇 Workbench default JRE（應指向 JDK 1.8）。
5. Finish → Apply and Close。

六、建立第一個 Dynamic Web Project

1. File → New → Dynamic Web Project。
2. Project name：MyFirstWeb。
3. Target runtime：選擇剛新增的 Apache Tomcat v9.0。
4. Dynamic web module version：3.1 (Tomcat 9) 或 4.0 (Tomcat 10)。
5. Configuration：Default Configuration for Apache Tomcat v9.0。
6. Next → Next → 勾選「Generate web.xml deployment descriptor」（傳統專案需手動配 Servlet，Servlet 3.0+ 可用註解免 web.xml）。
7. Finish。專案結構應包含 src、WebContent/WEB-INF/web.xml。

七、編寫測試 Servlet（註解式，無需 web.xml）

package com.demo.web;

import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;

@WebServlet("/hello")
public class HelloServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
        resp.setContentType("text/html;charset=UTF-8");
        resp.getWriter().write("
Hello, Eclipse + Tomcat!
Current time: " + new java.util.Date() + "
");
    }
}

注意：Tomcat 10 (Servlet 5.0+) 包名為 jakarta.servlet.*；Tomcat 9 (Servlet 4.0) 為 javax.servlet.*。請根據 Target Runtime 選擇正確包名。

八、部署運行與驗證

1. 專案右鍵 → Run As → Run on Server。
2. 選擇 Apache Tomcat v9.0 at localhost → Finish。
3. Eclipse 內建瀏覽器或外部瀏覽器訪問：https://localhost:8080/MyFirstWeb/hello。
4. 看到「Hello, Eclipse + Tomcat!」即部署成功。

九、常見問題快速排查

十、下一步學習建議

1. 掌握 Maven/Gradle 管理依賴，告別手動導 jar 包。
2. 學習 Servlet 3.0+ 註解配置、Filter/Listener、JSP/JSTL/EL。
3. 進階框架：Spring MVC → Spring Boot，體驗約定優於配置。
4. 版本控制：Git + GitHub/GitLab，團隊協作標配。
5. 容器化：Dockerfile 打包 Spring Boot + Tomcat/Jetty，雲原生部署。

環境是開發的基石，花時間把 Eclipse + JDK + Tomcat 搭穩、搭透，後續業務開發才能事半功倍。建議將本文配置步驟整理為團隊《開發環境標準化文檔》，新成員入職即可按圖索驥，避免「在我機器上能跑」的低級糾纏。