1. Maven 简介
Maven 是一个项目管理和构建自动化工具，主要用于 Java 项目。Maven 可以帮助开发者管理项目的构建、报告和文档，简化项目依赖管理。
2. 下载 Maven
-
访问 Maven 官方网站 [https://maven.apache.org/download.cgi\](https://maven.apache.org/download.cgi)
-
下载最新版本的 Maven 二进制压缩包（Binary zip archive）
-
Windows 用户选择 `.zip` 格式
-
Linux/Mac 用户选择 `.tar.gz` 格式
3. 安装 Maven
Windows 系统安装步骤
-
将下载的 zip 文件解压到您选择的目录，例如 `C:\Program Files\Apache\maven`
-
设置环境变量：
-
右键点击"此电脑"，选择"属性"
-
点击"高级系统设置"
-
点击"环境变量"按钮
-
在"系统变量"部分，点击"新建"
-
变量名设置为 `MAVEN_HOME`，变量值设置为 Maven 的安装目录（例如 `C:\Program Files\Apache\maven`）
-
找到"系统变量"中的 `Path` 变量，点击"编辑"
-
点击"新建"，添加 `%MAVEN_HOME%\bin`
-
点击"确定"保存所有更改
Linux 系统安装步骤
- 将下载的压缩包解压到您选择的目录：
```bash
tar -xzvf apache-maven-x.x.x-bin.tar.gz -C /opt/
```
- 配置环境变量，编辑 `~/.bashrc` 或 `~/.zshrc` 文件：
```bash
nano ~/.bashrc
```
- 添加以下内容：
```bash
export MAVEN_HOME=/opt/apache-maven-x.x.x
export PATH=PATH:MAVEN_HOME/bin
```
- 使环境变量生效：
```bash
source ~/.bashrc
```
macOS 系统安装步骤
- 将下载的压缩包解压到您选择的目录：
```bash
tar -xzvf apache-maven-x.x.x-bin.tar.gz -C /opt/
```
- 配置环境变量，编辑 `~/.bash_profile` 或 `~/.zshrc` 文件：
```bash
nano ~/.bash_profile
```
- 添加以下内容：
```bash
export MAVEN_HOME=/opt/apache-maven-x.x.x
export PATH=PATH:MAVEN_HOME/bin
```
- 使环境变量生效：
```bash
source ~/.bash_profile
```
4. 验证安装
要验证 Maven 是否安装成功，请在命令行中运行：
```bash
mvn -version
```
如果安装成功，将显示 Maven 版本、Java 版本和系统信息。
5. Maven 配置
配置本地仓库
Maven 默认的本地仓库位于 `~/.m2/repository`。如果需要自定义本地仓库位置，可以编辑 Maven 的 `settings.xml` 文件：
-
在 Maven 安装目录下的 `conf` 文件夹中找到 `settings.xml` 文件
-
复制 `settings.xml` 到 `~/.m2/` 目录下（如果不存在，请创建）
-
编辑 `~/.m2/settings.xml` 文件，修改本地仓库路径：
```xml
<settings>
<localRepository>D:\maven-repo</localRepository>
<!-- 其他配置 -->
</settings>
```
配置镜像仓库
为了加快依赖包的下载速度，可以配置国内的 Maven 镜像仓库。编辑 `settings.xml` 文件，在 `<mirrors>` 标签中添加：
```xml
<mirrors>
<mirror>
<id>aliyun</id>
<name>Aliyun Maven Repository</name>
<url>https://maven.aliyun.com/repository/public\</url>
<mirrorOf>central</mirrorOf>
</mirror>
</mirrors>
```
配置 JDK 版本
可以在 `settings.xml` 文件中配置默认的 JDK 版本：
```xml
<profiles>
<profile>
<id>jdk-1.8</id>
<activation>
<activeByDefault>true</activeByDefault>
<jdk>1.8</jdk>
</activation>
<properties>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
<maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
</properties>
</profile>
</profiles>
```
6. Maven 基本使用
创建 Maven 项目
```bash
mvn archetype:generate -DgroupId=com.example -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
```
构建项目
```bash
mvn clean package
```
运行测试
```bash
mvn test
```
安装到本地仓库
```bash
mvn install
```
7. 常见问题解决
下载依赖超时
如果下载依赖包时出现超时问题，可以尝试：
-
配置国内镜像仓库
-
增加超时时间，在 `settings.xml` 的 `<mirrors>` 标签后添加：
```xml
<settings>
<!-- 其他配置 -->
<servers>
<server>
<id>central</id>
<configuration>
<httpConfiguration>
<all>
<connectionTimeout>120000</connectionTimeout>
<readTimeout>120000</readTimeout>
</all>
</httpConfiguration>
</configuration>
</server>
</servers>
</settings>
```
找不到 JAVA_HOME
如果遇到 "No JAVA_HOME detected" 错误，请确保已经正确设置 JAVA_HOME 环境变量。