目錄
一、Maven的概念
1. 什么是Maven
2. 項目構建：從代碼到部署的標準化流程
2.1 Maven構建生命周期
2.2 傳統構建 vs Maven構建
3. 依賴管理：解決“JAR地獄”的利器
3.1 依賴聲明
3.2 依賴傳遞與沖突解決
4. Maven倉庫：依賴的存儲與分發
4.1 倉庫類型
4.2 配置鏡像倉庫
5. Maven模型
二、初識Maven
1. 安裝Maven
1.1 環境準備
1.2 配置步驟
2. 創建第一個Maven項目
2.1 項目結構
2.2 編寫POM文件
2.3?編寫代碼與測試
2.4?構建與運行
3.?Maven的第二個項目
3.1 項目結構
3.2 編寫POM文件
3.3?編寫代碼與測試
3.4 測試打包HelloFriend項目
四、常見問題與解決方案
五、總結
一、Maven的概念
1. 什么是Maven
1.1 Maven（意為“專家”）是一款專為Java項目設計的跨平臺項目管理工具，核心功能包括：
-
項目構建：自動化編譯、測試、打包、部署。
-
理想的項目構建：高度自動化，跨平臺，可重用的組件，標準化的流程
-
-
依賴管理：自動下載和管理第三方庫（JAR包）。
-
項目信息管理：統一維護項目元數據（如版本、開發者信息）。
1.2 為什么需要Maven？
-
傳統構建的痛點：
-
手動操作：開發人員需手動編譯、測試、部署，效率低。
-
依賴混亂：JAR包版本沖突，難以維護。
-
缺乏標準化：不同開發者的環境配置差異導致協作困難。
-
-
Maven的解決方案：
-
約定優于配置：默認目錄結構（如
src/main/java）減少配置成本。 -
生命周期管理：通過命令（如
mvn compile）自動化執行構建流程。 -
中央倉庫支持：從全球倉庫自動下載依賴，避免手動管理。
-
2. 項目構建：從代碼到部署的標準化流程
2.1 Maven構建生命周期
Maven定義了三套生命周期，每個生命周期包含多個階段（Phase）：
-
Clean：清理項目（刪除
target目錄）。 -
Default：核心構建流程（編譯、測試、打包、安裝）。
-
Site：生成項目文檔站點。
典型構建階段：
mvn clean # 清理
mvn compile # 編譯主代碼
mvn test # 運行單元測試
mvn package # 打包為JAR/WAR
mvn install # 安裝到本地倉庫
mvn deploy # 部署到遠程倉庫2.2 傳統構建 vs Maven構建
| 步驟 | 傳統方式 | Maven方式 |
|---|---|---|
| 編譯 | 手動執行javac | mvn compile |
| 測試 | 手動運行JUnit測試類 | mvn test（自動執行所有測試） |
| 依賴管理 | 手動下載并配置JAR包 | 聲明依賴，Maven自動下載 |
| 打包 | 手動生成JAR/WAR文件 | mvn package（按POM配置生成包） |
3. 依賴管理：解決“JAR地獄”的利器
3.1 依賴聲明
在pom.xml中通過坐標（GAV）聲明依賴：
<dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.12</version><scope>test</scope>
</dependency>-
GAV：
groupId（組織標識）、artifactId（項目名）、version（版本）。 -
scope：控制依賴的作用范圍（如
test表示僅測試階段有效）。
3.2 依賴傳遞與沖突解決
-
依賴傳遞：若A依賴B，B依賴C，則A自動引入C。
-
沖突解決：Maven采用最短路徑優先和先聲明優先原則，避免版本沖突。
4. Maven倉庫：依賴的存儲與分發
4.1 倉庫類型
-
本地倉庫：默認位于
~/.m2/repository，緩存下載的依賴。 -
遠程倉庫：
-
中央倉庫：Maven官方維護，包含絕大多數開源庫。
-
私服：企業內部搭建，加速依賴下載并管理私有組件。
-
4.2 配置鏡像倉庫
在settings.xml中配置阿里云鏡像加速下載：
<mirror><id>aliyun</id><name>Aliyun Maven</name><url>https://maven.aliyun.com/repository/public</url><mirrorOf>central</mirrorOf>
</mirror>5. Maven模型
二、初識Maven
1. 安裝Maven
1.1 環境準備
-
JDK 1.8+：確保
JAVA_HOME環境變量正確配置。 -
下載Maven：從官網下載二進制包（如
apache-maven-3.8.6-bin.zip）。
1.2 配置步驟
-
解壓到無中文路徑：如
D:\Tools\apache-maven-3.8.6。 -
設置環境變量：
-
MAVEN_HOME：Maven解壓目錄。
-
Path：添加
%MAVEN_HOME%\bin。
-
-
驗證安裝：
mvn -v
# 輸出示例：Apache Maven 3.8.6 ... Java version: 17.0.52. 創建第一個Maven項目
2.1 項目結構
Maven強制約定目錄結構，確保標準化：
Hello
├── src
│ ├── main
│ │ ├── java # Java源代碼
│ │ └── resources # 配置文件（如log4j.properties）
│ └── test
│ ├── java # 測試代碼
│ └── resources # 測試配置
├── target # 構建輸出（編譯后的類、JAR包）
└── pom.xml # 項目對象模型（核心配置文件）2.2 編寫POM文件
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>cn.tx.maven</groupId><artifactId>Hello</artifactId><version>0.0.1-SNAPSHOT</version><name>Hello</name><dependencies><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.9</version><scope>test</scope></dependency> </dependencies>
</project>2.3?編寫代碼與測試
（1）主類：在src/main/java/cn/tx/maven目錄下新建文件Hello.java
package cn.tx.maven;
public class Hello {public String sayHello(String name){return "Hello "+name+"!";}
}（2）測試類：在/src/test/java/cn/tx/maven目錄下新建測試文件HelloTest.java
package cn.tx.maven;
import org.junit.Test;
import static junit.framework.Assert.*;
public class HelloTest {@Testpublic void testHello(){Hello hello = new Hello();String results = hello.sayHello("maven");assertEquals("Hello maven!",results); }
}2.4?構建與運行
- 打開cmd命令行，進入Hello項目根目錄執行 mvn compile命令，查看根目錄變化
- cmd 中繼續錄入mvn clean命令，然后再次查看根目錄變化
- cmd 中錄入 mvn clean compile命令, 查看根目錄變化
- cmd 中錄入 mvn clean test命令，查看根目錄變化
- cmd 中錄入 mvn clean package命令,查看根目錄變化
- cmd 中錄入 mvn clean install 查看倉庫會把項目安裝到倉庫里
3.?Maven的第二個項目
3.1 項目結構
HelloFriend
├── src
│ ├── main
│ │ ├── java # Java源代碼
│ │ └── resources # 配置文件（如log4j.properties）
│ └── test
│ ├── java # 測試代碼
│ └── resources # 測試配置
├── target # 構建輸出（編譯后的類、JAR包）
└── pom.xml # 項目對象模型（核心配置文件）3.2 編寫POM文件
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>cn.tx.maven</groupId><artifactId>HelloFriend</artifactId><version>0.0.1-SNAPSHOT</version><name>HelloFriend</name><dependencies><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.9</version><scope>test</scope></dependency> <dependency><groupId>cn.tx.maven</groupId><artifactId>Hello</artifactId><version>0.0.1-SNAPSHOT</version><scope>compile</scope></dependency> </dependencies>
</project>3.3?編寫代碼與測試
（1）主類：在src/main/java/cn/tx/maven目錄下新建文件HelloFriend.java
package cn.tx.maven;import cn.tx.maven.Hello;public class HelloFriend {public String sayHelloToFriend(String name){Hello hello = new Hello();String str = hello.sayHello(name)+" I am "+this.getMyName();System.out.println(str);return str;}public String getMyName(){return "John";}}（2）測試類：在/src/test/java/cn/tx/maven目錄下新建測試文件HelloFriendTest.java
package cn.tx.maven;import static junit.framework.Assert.assertEquals;import org.junit.Test;import cn.tx.maven.Hello;public class HelloFriendTest {@Testpublic void tesHelloFriend(){HelloFriend helloFriend = new HelloFriend();String results = helloFriend.sayHelloToFriend("zhangsan");assertEquals("Hello zhangsan! I am John",results); }
}3.4 測試打包HelloFriend項目
在HelloFriend目錄下執行命令mvn package。
四、常見問題與解決方案
-
依賴下載失敗：
-
檢查鏡像配置：確保
settings.xml中配置了可靠的鏡像源（如阿里云）。 -
清理本地倉庫：刪除
~/.m2/repository中損壞的依賴目錄，重新下載。
-
-
構建時報錯“找不到符號”：
-
檢查JDK版本：確保POM中配置的JDK版本與環境一致。
-
重新編譯：執行
mvn clean compile。
-
-
插件兼容性問題：
-
更新插件版本：在Maven中央倉庫查找最新版本。
-
五、總結
Maven通過標準化構建流程和自動化依賴管理，極大提升了Java項目的開發效率與協作能力。從安裝配置到創建第一個項目，再到管理復雜依賴，Maven始終是開發者不可或缺的工具。
