Eclipse 中將 Web 專案導出為 WAR 包的完整圖文教程

WAR 包簡介

WAR (Web Application Archive) 是 Java Web 應用的標準部署格式，本質是包含 WEB-INF、靜態資源、類文件的 ZIP 壓縮包。將專案打包為 WAR 可直接部署至 Tomcat、Jetty、JBoss 等 Servlet 容器的 webapps 目錄，容器啟動時自動解壓部署。

Eclipse 導出 WAR 步驟詳解

1. 選中目標專案

在 Project Explorer 中右鍵點選 Web 專案（如 venus），選擇 Export...。

2. 選擇導出類型

在彈出向導中展開 Web 節點，選擇 WAR file，點擊 Next >。

3. 配置導出選項

• Destination：點擊 Browse... 選擇 WAR 檔案保存路徑（如 D:/deploy/venus.war）。
• Overwrite existing file：勾選以允許覆蓋同名文件。
• Export source files：可選，將 Java 源碼打包進 WAR（WEB-INF/src），便於遠端除錯，生產環境建議取消勾選。
• Optimize for specific server runtime：若專案綁定 Targeted Runtimes（如 Apache Tomcat 9.0），勾選可生成針對該容器優化的部署描述符。

4. 完成導出

點擊 Finish，Eclipse 將編譯專案、打包資源，在控制台輸出進度。完成後即可在目標目錄看到 venus.war。

命令列替代方案（Maven/Gradle）

現代專案建議使用構建工具自動化打包，而非依賴 IDE 手動操作：

# Maven
mvn clean package -DskipTests
# 輸出：target/venus.war

# Gradle
./gradlew war
# 輸出：build/libs/venus.war

優勢：可整合 CI/CD 流程、環境一致性、依賴管理、測試執行。

部署驗證

1. 將 WAR 複製至 Tomcat webapps/ 目錄。
2. 啟動 Tomcat（bin/startup.sh 或 startup.bat）。
3. 觀察日誌：Deploying web application archive venus.war → Deployment of web application archive venus.war has finished。
4. 瀏覽器訪問 https://localhost:8080/venus/ 驗證應用啟動成功。

常見問題排查

總結

Eclipse 圖形化導出 WAR 適合快速驗證與學習，生產環境務必採用 Maven/Gradle 自動化構建。掌握 WAR 結構（WEB-INF/classes、WEB-INF/lib、web.xml、靜態資源）對排查部署問題至關重要。