Maven 安裝步驟
- 下載：
https://maven.apache.org/download.cgi → Binary zip
- 解壓至任意目錄，如
D:\Maven\apache-maven-3.3.9
- 配置環境變數：
| 變數名 | 變數值 |
|---|
| MAVEN_HOME | D:\Maven\apache-maven-3.3.9 |
| Path | 追加 %MAVEN_HOME%\bin;（分號分隔） |
驗證安裝
cmd> mvn -version
Apache Maven 3.3.9
Maven home: D:\Maven\apache-maven-3.3.9
Java version: 1.8.0_77
Default locale: zh_TW, platform encoding: Big5
OS name: "windows 7", version: "6.1", arch: "amd64", family: "windows"
本地倉庫配置
- 編輯
%MAVEN_HOME%\conf\settings.xml
- 找到
<localRepository> 標籤（預設被註解）
- 取消註解並設定路徑：
<localRepository>D:\Maven\maven_repo</localRepository>
- 建立對應目錄
- 複製
settings.xml 至 D:\Maven\settings.xml（MyEclipse 整合需用）
MyEclipse 整合 Maven
- Window → Preferences
- MyEclipse → Maven4MyEclipse → Maven
- 設定三個關鍵路徑：
| 設定項 | 路徑範例 |
|---|
| Maven 安裝目錄 | D:\Maven\apache-maven-3.3.9 |
| User Settings | D:\Maven\settings.xml |
| Global Settings | D:\Maven\apache-maven-3.3.9\conf\settings.xml |
- Apply → OK
- 驗證：File → New → Other → MyEclipse → Maven4MyEclipse → Maven Project 可見選項即成功
Maven 專案建立與結構
my-maven-project/
├── pom.xml # 專案核心配置
├── src/
│ ├── main/
│ │ ├── java/ # 主程式碼
│ │ └── resources/ # 配置檔、屬性檔
│ └── test/
│ ├── java/ # 測試程式碼
│ └── resources/ # 測試資源
└── target/ # 編譯輸出（自動生成）
核心 pom.xml 模板
<project xmlns="https://maven.apache.org/POM/4.0.0">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>my-project</artifactId>
<version>1.0.0-SNAPSHOT</version>
<packaging>jar</packaging>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
</properties>
<dependencies>
<!-- 依賴範例 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.1</version>
</plugin>
</plugins>
</build>
</project>
常用命令速查
| 命令 | 作用 |
|---|
| mvn clean | 清理 target 目錄 |
| mvn compile | 編譯主程式碼 |
| mvn test | 執行單元測試 |
| mvn package | 打包（jar/war） |
| mvn install | 安裝至本地倉庫 |
| mvn deploy | 部署至遠端倉庫 |
| mvn dependency:tree | 查看依賴樹 |
| mvn help:effective-pom | 查看有效 POM |
依賴範圍說明
| Scope | 編譯 | 測試 | 執行 | 打包 | 說明 |
|---|
| compile (預設) | Y | Y | Y | Y | 標準依賴 |
| test | - | Y | - | - | 僅測試階段 |
| provided | Y | Y | Y | - | 容器提供 |
| runtime | - | Y | Y | Y | 執行時需要 |
| system | Y | Y | Y | - | 本地 JAR，需 systemPath |
| import | - | - | - | - | 導入 BOM |
常見問題解決
| 問題 | 解決方案 |
|---|
| 下載依賴慢 | 配置阿里雲鏡像：settings.xml → mirrors → alimaven |
| 版本衝突 | dependency:tree 分析 → exclusion 排除傳遞依賴 |
| 編碼問題 | properties 設定 project.build.sourceEncoding=UTF-8 |
| MyEclipse 不識別 Maven 專案 | 專案右鍵 → Maven → Update Project → Force Update |
| 缺少 archetype | 建立專案時選擇 maven-archetype-quickstart |
