Eclipse 建立 Maven Web 專案完整圖文教學

Eclipse 建立 Maven Web 專案完整圖文教學

本文詳細記錄在 Eclipse IDE 中從零開始建立 Maven Web 專案的完整步驟，包含專案建立、目錄結構調整、JDK 設定、Tomcat 部署等實務操作，適合初學者參考。

1. 建立 Maven 專案

1. 選單 File → New → Other…
2. 輸入 maven 選擇 Maven Project，點擊 Next
3. 勾選 Create a simple project 或直接 Next
4. 選擇 Archetype：maven-archetype-webapp
5. 填寫 Group Id、Artifact Id，Finish

2. 解決專案建立失敗（指定 settings.xml）

若出現「Could not resolve archetype」錯誤，通常是未指定 Maven settings.xml。解決方式：

1. 右鍵專案 → Properties → Maven → User Settings
2. 勾選 User Settings，瀏覽選擇本機 settings.xml
3. Apply 並重新建立專案

3. 調整 Java Build Path 目錄結構

Maven Web 專案預設缺少 src/main/java、src/test/java、src/test/resources，需手動新增：

1. 右鍵專案 → Build Path → Configure Build Path → Source
2. 移除錯誤的 Source Folder
3. 點擊 Add Folder → Create New Folder 依序建立上述三個資料夾
4. 設定 src/test/java、src/test/resources 的 Output folder 為 target/test-classes，避免與主程式 target/classes 混淆

4. 設定 JDK 與專案 Facet

• Libraries：將預設 JRE 替換為已安裝的 JDK（如 jdk1.8）
• Project Facets：勾選 Dynamic Web Module，版本選 2.5（對應 Java 7）或 3.0+（Java 8+）
• Deployment Assembly：移除測試資料夾，避免打包進 WAR

5. pom.xml 加入常用依賴

<dependencies>
  <!-- Java EE API -->
  <dependency>
    <groupId>javax</groupId>
    <artifactId>javaee-api</artifactId>
    <version>7.0</version>
    <scope>provided</scope>
  </dependency>
  <!-- 其他常用：JUnit, Log4j, Jackson, FileUpload 等 -->
</dependencies>

6. 設定與啟動 Tomcat

1. Eclipse Servers 視圖 → 右鍵 New → Server 選擇 Tomcat 版本
2. 設定 Tomcat 安裝目錄、JRE
3. 將專案 Add and Remove 到 Server
4. 啟動 Server，瀏覽器訪問 https://localhost:8080/專案名/

小結

完成上述步驟，即可在 Eclipse 中擁有標準化的 Maven Web 專案環境，後續可整合 Spring、MyBatis 等框架進行企業級開發。