为什么你的Maven总是安装失败？
作为Java开发者必备的构建工具，Maven在实际安装过程中常常遇到各种问题。从JDK版本不匹配到环境变量配置错误，这些看似简单的问题往往让初学者耗费数小时。本文将用最清晰的Maven安装详细步骤，带你避开这些坑。
准备工作
在开始Maven安装前，需要确保以下基础环境就绪：
- JDK 1.7+ - 执行`java -version`验证
- 500MB磁盘空间 - 用于存储本地仓库
- 系统管理员权限 - 配置环境变量时需要
常见问题排查
你可能会问：为什么Maven要求JDK而不是JRE？ 因为Maven编译时需要JDK提供的工具链，而不仅仅是运行时环境。
Windows系统安装步骤
- 从官网下载最新稳定版二进制包（建议选择zip格式）
- 解压到非中文路径，例如`C:\Program Files\apache-maven-3.8.6`
- 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
- 在系统变量新建`MAVEN_HOME`，值为解压路径
- 编辑Path变量，追加`%MAVEN_HOME%\bin`
验证安装
打开CMD执行：
mvn -v
正确输出应包含Maven版本和JDK信息，如果报错'mvn'不是内部命令，说明环境变量配置有误。
Mac/Linux系统安装
通过Homebrew可以更简单地完成安装：
- 安装Homebrew（如已安装跳过此步）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- 执行安装命令：
brew install maven
- 验证安装：
mvn --version
手动配置注意事项
- 解压后建议将文件夹移动到`/usr/local`目录
- 环境变量配置在`~/.bash_profile`或`~/.zshrc`
- 记得执行`source`命令使配置生效
IDE集成配置
主流IDE都支持Maven，但需要正确配置：
| IDE | 配置路径 |
|---|---|
| IntelliJ IDEA | Settings → Build → Maven |
| Eclipse | Preferences → Maven |
有人会说：为什么IDE自带Maven还要单独安装？ 因为统一的环境更利于团队协作，避免因IDE内置版本不同导致构建差异。
构建你的第一个项目
完成Maven安装后，可以通过原型快速创建项目：
mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
这个命令会生成标准目录结构，其中：
- src/main/java - 主代码目录
- src/test/java - 测试代码目录
- pom.xml - 项目核心配置文件
遇到网络问题时，可以尝试配置阿里云镜像。在`pom.xml`同级目录创建`settings.xml`文件，添加镜像配置能显著提升依赖下载速度。