Eclipse 整合 Maven 建立 Web 專案完整教學：環境配置、倉庫設定與專案建立

Eclipse 整合 Maven 建立 Web 專案完整教學：環境配置、倉庫設定與專案建立

Maven 是 Java 專案構建與依賴管理的標準工具。本文提供 Windows + Eclipse 環境下，從 JDK/Maven 安裝、環境變數配置、Eclipse 整合、本地倉庫設定到建立 Web 專案的完整圖文步驟。

一、軟體下載

二、環境變數配置 (Windows)

1. JDK 環境變數

# 系統變數
JAVA_HOME = D:\Program Files\Java\jdk1.8.0_xxx
CLASSPATH = %JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar
PATH = %PATH%;%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin

2. Maven 環境變數

# 系統變數
MAVEN_HOME = D:\Program Files\apache-maven-3.3.9
PATH = %PATH%;%MAVEN_HOME%\bin

3. 驗證配置

cmd> java -version
cmd> mvn -version
# 顯示版本資訊即配置成功

三、Maven 本地倉庫配置

1. 編輯 %MAVEN_HOME%\conf\settings.xml
2. 修改 <localRepository> 標籤：

   <localRepository>F:\maven\repo</localRepository>

   （建議非系統盤、路徑無中文/空格）
3. 驗證：cmd> mvn help:system → 觀察倉庫目錄生成檔案

四、Eclipse 整合 Maven

1. Window → Preferences → Maven
2. Installations → Add → External：選擇 Maven 安裝目錄（D:\Program Files\apache-maven-3.3.9）
3. 勾選新增項目 → Apply and Close
4. User Settings → Global/User Settings：瀏覽選擇 settings.xml → Apply and Close

五、建立 Maven Web 專案

1. File → New → Maven Project
2. 勾選 Create a simple project (skip archetype selection) → Next
3. 填寫坐標：

   Group Id: com.example
   Artifact Id: myweb
   Version: 0.0.1-SNAPSHOT
   Packaging: war  (關鍵：Web 專案必須 war)
   Name: My Web Project
   Description: Maven Web Project Demo
   

4. Finish → 專案結構生成：

myweb
├── src
│   ├── main
│   │   ├── java
│   │   ├── resources
│   │   └── webapp
│   │       ├── WEB-INF
│   │       │   └── web.xml
│   │       └── index.jsp
│   └── test
│       ├── java
│       └── resources
├── pom.xml
└── target

六、轉換為 Dynamic Web Project (關鍵步驟)

Maven 專案預設非 Eclipse Web 專案，需轉換以支援伺服器部署：

1. 右鍵專案 → Properties → Project Facets
2. 勾選 Dynamic Web Module (版本 3.0/3.1/4.0) → Apply
3. 彈出 Further configuration available → 點擊配置：
   • Content Directory: src/main/webapp
   • Generate web.xml deployment descriptor: 勾選
4. 確定 → 專案圖標變為 Web 專案圖標，可加入 Tomcat 部署

七、pom.xml 基礎配置範例

<project xmlns="https://maven.apache.org/POM/4.0.0" ...>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>myweb</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>war</packaging>
    
    <properties>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <failOnMissingWebXml>false</failOnMissingWebXml>
    </properties>
    
    <dependencies>
        <!-- Servlet API (provided 由容器提供) -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
            <scope>provided</scope>
        </dependency>
        <!-- JSP API -->
        <dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>javax.servlet.jsp-api</artifactId>
            <version>2.3.1</version>
            <scope>provided</scope>
        </dependency>
        <!-- JSTL -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
            <version>1.2</version>
        </dependency>
    </dependencies>
    
    <build>
        <finalName>myweb</finalName>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <version>3.2.3</version>
                <configuration>
                    <failOnMissingWebXml>false</failOnMissingWebXml>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

八、常見問題排查

總結

Eclipse + Maven 標準化流程：安裝配置 → 倉庫設定 → IDE 整合 → 建立專案 (war) → 轉換 Web Facet → 完善 pom.xml → 部署驗證。掌握此流程，可快速建立標準化、可攜遷、依賴管理完善的 Java Web 專案骨架。後續建議學習：Maven 多模組專案、Profile 環境隔離、插件進階配置、CI/CD 整合。