← 返回首页

第1章: Maven 是什么与安装

从手工管理 jar 包，到让工具帮你管理一切

Maven 是做什么的？

Maven 是 Java 领域最常用的项目构建与依赖管理工具，核心价值有两点：

自动管理依赖： 只需在配置里写明需要哪个库、哪个版本，Maven 会自动从仓库下载并放在正确位置
统一构建流程： 一套命令完成编译、测试、打包、安装等步骤，避免每个项目“各玩各的脚本”

Maven 到底解决了哪些“日常痛点”？

依赖传递：你只声明一个依赖，Maven 会把它依赖的依赖也一并下载（可控）
依赖冲突：同一个库不同版本同时出现时，有一套可解释、可排查的规则
可复现构建：同一份 pom.xml，在不同机器上用同样命令得到一致产物
标准目录结构：默认约定（src/main/java、src/test/java）降低协作成本
插件生态：测试、打包、静态检查、发布、代码生成，都可通过插件串起来

如果没有 Maven 会怎样？

需要手动去网站下载各种 jar，版本多了很难管理
不同项目目录结构各不相同，新人接手项目成本高
构建流程全靠文档和口头说明，很容易漏步骤

一句话总结： Maven 帮你记住项目需要哪些 jar，并且用同一套命令构建所有项目。

安装 Maven

1. 检查是否已安装

mvn -v

你需要准备什么？

JDK：Maven 本身用 Java 写的，必须先装 JDK（建议 8/11/17 任选其一，与项目要求一致）
JAVA_HOME：尽量配置好，避免 IDE/命令行使用不同 JDK 导致“我机器能跑你机器不行”

建议：先让学员理解：mvn -v 输出里最关键的是 Maven 版本、Java version、Java home。

2. 基本安装步骤（以压缩包方式）

从官网下载安装包：https://maven.apache.org
解压到一个目录，例如：C:\apache-maven-3.x 或 /opt/maven
配置环境变量：MAVEN_HOME 和 PATH

更推荐的安装方式（按系统）

macOS（Homebrew）

brew install maven
mvn -v

Windows（环境变量关键点）

MAVEN_HOME 指向 Maven 解压目录（包含 bin）
把 %MAVEN_HOME%\bin 加入 Path
确认 java -version 与 mvn -v 使用同一个 JDK

Linux（包管理器或压缩包）

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install -y maven

# CentOS/RHEL
sudo yum install -y maven

第一次就配对：~/.m2 与 settings.xml

Maven 的默认本地仓库目录是：~/.m2/repository。你可以通过 ~/.m2/settings.xml 做一些“企业常用配置”。

1) 改本地仓库位置（可选）

<settings>
  <localRepository>/path/to/.m2/repository</localRepository>
</settings>

2) 配置镜像（国内/企业私服常用）

<mirrors>
  <mirror>
    <id>aliyun</id>
    <name>Aliyun Maven Mirror</name>
    <url>https://maven.aliyun.com/repository/public</url>
    <mirrorOf>central</mirrorOf>
  </mirror>
</mirrors>

3) 代理（公司网络需要时）

<proxies>
  <proxy>
    <id>corp-proxy</id>
    <active>true</active>
    <protocol>http</protocol>
    <host>proxy.company.com</host>
    <port>8080</port>
  </proxy>
</proxies>

课堂建议：让学员在本机找到 ~/.m2/repository，观察一个依赖的目录结构（按 groupId 分段）。

常见问题与排查

mvn: command not found：通常是 PATH 没配置到 Maven 的 bin
JAVA_HOME is not defined correctly：JAVA_HOME 指错 JDK 或指到了 JRE
依赖下载很慢/失败：考虑镜像、代理，或检查 DNS/公司网络拦截
同事电脑能下你电脑下不了：对比双方 ~/.m2/settings.xml、以及 mvn -v 输出

# 打开调试日志（排查下载/解析问题很有用）
mvn -X -v

# 显示当前实际生效的配置
mvn help:effective-settings

验证安装

mvn -v

如果能看到 Maven 版本、Java 版本等信息，说明安装成功。

📝 章节练习

练习 1：完成本机 Maven 安装

按照本章步骤在本机安装 Maven
用 mvn -v 验证

练习 2：理解 Maven 的角色

思考并写在笔记里：

没有 Maven 时，管理 jar 包会有什么问题？
Maven 在项目中帮你做了哪些重复性工作？

本章小结

知道了 Maven 是用来管理依赖与构建 Java 项目的工具
完成了 Maven 的安装和基础验证
理解了 ~/.m2 与 settings.xml 的价值（本地仓库、镜像、代理）