JSP/Servlet 開發環境從零搭建：JDK、Tomcat、IDE 配置全流程圖解

初學者最容易卡在環境變量配置、Tomcat 整合、Servlet 註冊這幾個環節。本文以 Windows 為例，採用「最小化工具鏈」策略：JDK + Tomcat + VS Code/IDEA，逐步驗證，拒絕一鍵安裝包帶來的黑盒問題。

一、核心組件下載與版本選擇（2024 年推薦）

注意：Tomcat 10+ 采用 Jakarta EE 9+ 命名空間（jakarta.servlet.*），舊代碼需遷移包名；若維護老項目請用 Tomcat 9.x (javax.servlet.*)。

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

1. 運行安裝程式，建議安裝路徑 D:\Java\jdk-21（避免中文、空格、權限問題）。
2. 右鍵「此電腦」→ 屬性 → 高級系統設置 → 環境變量 → 系統變量：

# 新建 JAVA_HOME
變量名：JAVA_HOME
變量值：D:\Java\jdk-21

# 編輯 Path，新增兩條（順序靠前）
%JAVA_HOME%\bin
%JAVA_HOME%\jre\bin  (JDK 21 無 jre 目錄則略過)

# 新建 CLASSPATH（可選，現代構建工具不依賴）
.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar

3. 驗證：打開新 CMD，輸入 java -version、javac -version 顯示版本號即成功。

三、Tomcat 安裝與驗證

1. 解壓 apache-tomcat-10.1.x.zip 到 D:\Java\apache-tomcat-10.1.x。
2. 系統變量新增 CATALINA_HOME = D:\Java\apache-tomcat-10.1.x，Path 追加 %CATALINA_HOME%\bin。
3. CMD 執行 startup.bat，瀏覽器訪問 https://localhost:8080 出現貓首頁即成功。
4. 關閉：shutdown.bat 或 Ctrl+C。

四、IDE 整合 Tomcat（以 IDEA 為例）

1. File → Settings → Build, Execution, Deployment → Application Servers → + → Tomcat Server → 指定 CATALINA_HOME。
2. 新建 Java Web 項目：File → New → Project → Jakarta EE → Web Application → 勾選「Generate web.xml」。
3. Run → Edit Configurations → + → Tomcat Server → Local → Deployment 標籤 → + → Artifact 選擇 exploded war → Apply。
4. 點擊綠色三角運行，IDEA 自動部署並打開瀏覽器。

五、HelloWorld 級 Servlet 與 JSP 驗證

1. Servlet（Jakarta EE 9+ 註解式，無需 web.xml）

package com.example.demo;

import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.*;
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("<h1>Hello, Jakarta Servlet!</h1>");
    }
}

2. JSP src/main/webapp/index.jsp

<%@ page contentType="text/html;charset=UTF-8" %>
<html><body>
<h2>JSP 渲染時間：${new java.util.Date()} </h2>
<a href="hello">跳轉 Servlet</a>
</body></html>

六、常見坑點速查表

環境搭建的核心是「版本對齊、路徑無空格、環境變量生效、IDE 識別正確」。建議初學者先跑通最小 Demo，再引入 Maven/Gradle、Spring Boot 等框架，避免一次引入過多變量導致排查困難。