## 1. Maven 简介
Maven 是一个项目管理和构建自动化工具，主要用于 Java 项目。Maven 可以帮助开发者管理项目的构建、报告和文档，简化项目依赖管理。
## 2. 下载 Maven
1. 访问 Maven 官方网站 [https://maven.apache.org/download.cgi](https://maven.apache.org/download.cgi)
2. 下载最新版本的 Maven 二进制压缩包（Binary zip archive）
- Windows 用户选择 `.zip` 格式
- Linux/Mac 用户选择 `.tar.gz` 格式
## 3. 安装 Maven
### Windows 系统安装步骤
1. 将下载的 zip 文件解压到您选择的目录，例如 `C:\Program Files\Apache\maven`
2. 设置环境变量：
- 右键点击"此电脑"，选择"属性"
- 点击"高级系统设置"
- 点击"环境变量"按钮
- 在"系统变量"部分，点击"新建"
- 变量名设置为 `MAVEN_HOME`，变量值设置为 Maven 的安装目录（例如 `C:\Program Files\Apache\maven`）
- 找到"系统变量"中的 `Path` 变量，点击"编辑"
- 点击"新建"，添加 `%MAVEN_HOME%\bin`
- 点击"确定"保存所有更改
### Linux 系统安装步骤
1. 将下载的压缩包解压到您选择的目录：
```bash
tar -xzvf apache-maven-x.x.x-bin.tar.gz -C /opt/
```
2. 配置环境变量，编辑 `~/.bashrc` 或 `~/.zshrc` 文件：
```bash
nano ~/.bashrc
```
3. 添加以下内容：
```bash
export MAVEN_HOME=/opt/apache-maven-x.x.x
export PATH=$PATH:$MAVEN_HOME/bin
```
4. 使环境变量生效：
```bash
source ~/.bashrc
```
### macOS 系统安装步骤
1. 将下载的压缩包解压到您选择的目录：
```bash
tar -xzvf apache-maven-x.x.x-bin.tar.gz -C /opt/
```
2. 配置环境变量，编辑 `~/.bash_profile` 或 `~/.zshrc` 文件：
```bash
nano ~/.bash_profile
```
3. 添加以下内容：
```bash
export MAVEN_HOME=/opt/apache-maven-x.x.x
export PATH=$PATH:$MAVEN_HOME/bin
```
4. 使环境变量生效：
```bash
source ~/.bash_profile
```
## 4. 验证安装
要验证 Maven 是否安装成功，请在命令行中运行：
```bash
mvn -version
```
如果安装成功，将显示 Maven 版本、Java 版本和系统信息。
## 5. Maven 配置
### 配置本地仓库
Maven 默认的本地仓库位于 `~/.m2/repository`。如果需要自定义本地仓库位置，可以编辑 Maven 的 `settings.xml` 文件：
1. 在 Maven 安装目录下的 `conf` 文件夹中找到 `settings.xml` 文件
2. 复制 `settings.xml` 到 `~/.m2/` 目录下（如果不存在，请创建）
3. 编辑 `~/.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 环境变量。