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

Java 開發環境零基礎搭建：JDK 安裝、環境變量、Tomcat 配置與驗證

編輯：Java 相關知識

Java 學習第一步：從零搭建可運行、可開發、可部署的完整環境。本文圖文並茂講解 JDK 下載安裝、三大環境變量 (JAVA_HOME/CLASSPATH/PATH) 配置原理、Tomcat 安裝部署與項目發布三種方式、常見驗證命令與排錯，適合絕對新手跟著做即可成功。

一、JDK 下載與安裝

官網：Oracle JDK 或 Eclipse Temurin (OpenJDK 構建，推薦)。
選擇 LTS 版本：JDK 17 或 JDK 21 (長期支持)。
Windows：下載 .msi 安裝包，雙擊按提示安裝，默認路徑 C:\Program Files\Java\jdk-17。
Linux/Mac：解壓 .tar.gz 到 /opt/java 或 /usr/lib/jvm。

二、環境變量配置 (Windows 為例)

右鍵「此電腦」→ 屬性 → 高級系統設置 → 環境變量 → 系統變量新建/編輯

變量名	變量值	作用
JAVA_HOME	C:\Program Files\Java\jdk-17	JDK 安裝根目錄，其他工具 (Maven/Gradle/Tomcat/IDEA) 依賴此變量定位 JDK
CLASSPATH	.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar	類加載路徑：`.` 代表當前目錄；`dt.jar` 運行環境類庫，`tools.jar` 編譯工具類庫 (JDK 9+ 已模塊化，可省略)
PATH	%JAVA_HOME%\bin	將 JDK 可執行程序目錄加入系統路徑，使 `javac`/`java`/`javadoc` 任意目錄可用

⚠️ 注意：多值之間用分號 ; 分隔，無空格。編輯 PATH 時建議將 %JAVA_HOME%\bin 置於最前，優先使用當前 JDK 版本。

三、驗證安裝

C:\> java -version
java version "17.0.10" 2024-01-16 LTS
Java(TM) SE Runtime Environment (build 17.0.10+7-LTS-237)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.10+7-LTS-237, mixed mode, sharing)

C:\> javac -version
javac 17.0.10

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

輸出版本信息無誤即安裝成功。

四、Tomcat 安裝與配置

1. 下載解壓

官網：tomcat.apache.org → 下載 apache-tomcat-9.0.x.zip (或 10.1.x for Servlet 6.0/JDK 11+)。
解壓到無中文、無空格路徑，如 D:\apache-tomcat-9.0.85。

2. 配置 Tomcat 環境變量 (可選，便於啟動腳本)

CATALINA_HOME = D:\apache-tomcat-9.0.85
CATALINA_BASE = D:\apache-tomcat-9.0.85 (多實例時不同)
PATH += ;%CATALINA_HOME%\bin

3. 啟動/關閉

# Windows
startup.bat      # 彈出控制台窗口運行
shutdown.bat     # 正常關閉

# Linux/Mac
./startup.sh
./shutdown.sh

瀏覽器訪問 https://localhost:8080 出現 Tomcat 貓首頁即成功。

4. 修改端口 (避免 8080 衝突)

編輯 conf/server.xml：

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />

將 port 改為 8081 等，重啟生效。

五、Tomcat 部署項目三種方式

方式一：webapps 目錄直接放 WAR/解壓目錄 (最簡單)

將打包好的 myapp.war 放入 webapps/，Tomcat 自動熱部署解壓為 myapp/。
訪問 https://localhost:8080/myapp/。

方式二：server.xml 配置 Context (傳統)

編輯 conf/server.xml <Host> 內：

<Context docBase="D:\projects\myapp" path="/myapp" reloadable="true" />

docBase：項目絕對路徑 (含 WEB-INF/web.xml)。
path：訪問路徑前綴。
reloadable：開發階段設 true 熱加載類文件變更。

方式三：Catalina/localhost/xxx.xml (推薦，不改 server.xml)

在 conf/Catalina/localhost/ 下新建 myapp.xml。
內容：

<?xml version="1.0" encoding="UTF-8"?>
<Context docBase="D:\projects\myapp" path="/myapp" reloadable="true" />

優點：項目級配置隔離、不污染主配置、易於版本控制。

六、Eclipse/IDEA 整合 Tomcat

Eclipse：Server 視圖 → New Server → Apache Tomcat v9.0 → 選擇安裝目錄 → Add 项目 → Start。
IDEA：Run/Debug Configuration → + → Tomcat Server → Local → Deployment 標籤添加 Artifact (war/exploded) → Application context 設定路徑。

七、常見問題速查

現象	原因/解決
java -version 报 "不是內部命令"	PATH 未生效：重開 CMD、檢查分號、確認 %JAVA_HOME%\bin 存在
Tomcat 閃退	JAVA_HOME 未配置或指向 JRE 而非 JDK；端口被佔用 (netstat -ano \| findstr 8080)
訪問 404	項目未部署、Context path 錯誤、web.xml 缺失 (Servlet 3.0+ 可無)
中文亂碼	server.xml Connector 加 `URIEncoding="UTF-8"`；請求/響應過濾器設編碼
Eclipse 發布項目 JAR 缺失	Deployment Assembly 缺少 Maven Dependencies；或未勾選 "Publish module contexts"