## 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 環境變量。
)
