下載與安裝
- 官網下載：https://maven.apache.org/download.html →
apache-maven-3.9.x-bin.tar.gz
- 解壓至慣用目錄 (如
/usr/local/ 或 ~/dev/tools/)：
tar -xzf apache-maven-3.9.6-bin.tar.gz -C /usr/local/
環境變數配置 (永久生效)
Zsh (macOS Catalina+ 預設)
vim ~/.zshrc
# 在檔案末尾加入
export M2_HOME=/usr/local/apache-maven-3.9.6
export PATH=$PATH:$M2_HOME/bin
# 確保 JAVA_HOME 已設定
export JAVA_HOME=$(/usr/libexec/java_home)
# 套用
source ~/.zshrc
Bash (舊版 macOS)
vim ~/.bash_profile
# 同樣內容
source ~/.bash_profile
驗證安裝
mvn -version
# 輸出範例:
# Apache Maven 3.9.6
# Maven home: /usr/local/apache-maven-3.9.6
# Java version: 17.0.2, vendor: Oracle Corporation
# Java home: /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
# Default locale: zh_TW, platform encoding: UTF-8
# OS name: "mac os x", version: "13.4", arch: "aarch64", family: "mac"
建立第一個 Maven 專案
方式一：原型生成 (互動式)
cd ~/workspace
mvn archetype:generate \
-DgroupId=com.example \
-DartifactId=my-first-app \
-DarchetypeArtifactId=maven-archetype-quickstart \
-DinteractiveMode=false
方式二：IDE 整合 (推薦新手)
- IntelliJ IDEA：
File → New → Project → Maven，勾選 Create from archetype 選 quickstart
- VS Code：安裝
Extension Pack for Java + Maven for Java，命令面板 Maven: Create Project
專案結構解析
my-first-app/
├── pom.xml # 專案核心配置 (座標、依賴、建構)
├── src/
│ ├── main/
│ │ ├── java/ # 主程式碼
│ │ └── resources/ # 配置文件
│ └── test/
│ ├── java/ # 測試碼
│ └── resources/ # 測試資源
核心命令速查
| 命令 | 作用 |
|---|
mvn clean | 刪除 target 目錄 |
mvn compile | 編譯主程式碼 |
mvn test | 執行單元測試 |
mvn package | 打包 (jar/war) |
mvn install | 安裝至本地倉庫 (~/.m2/repository) |
mvn dependency:tree | 查看依賴樹 |
mvn help:effective-pom | 查看合併後完整 POM |
常見問題與解決
- 下載依賴極慢：配置阿里雲鏡像 → 編輯
~/.m2/settings.xml 加入 <mirror> 指向 maven.aliyun.com
- 編碼警告：POM 加入
<properties><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties>
- 版本衝突：用
mvn dependency:tree 定位 → <exclusion> 排除傳遞依賴
- M1/M2 晶片 JDK 架構不符：確保下載 ARM64 版 JDK (如 Azul Zulu、Oracle ARM64)
進階建議
- 使用
Maven Wrapper (mvnw) 鎖定專案 Maven 版本，避免環境差異
- 掌握
Profile 區分 dev/test/prod 環境配置
- 學習
BOM (Bill of Materials) 統一依賴版本管理
