Maven 下载与安装完整指南（Windows/Mac/Linux）

1. 什么是 MavenApache Maven 是一个强大的项目管理和构建自动化工具主要用于 Java 项目。它基于项目对象模型 (POM)的概念可以管理项目的构建、报告和文档。Maven 简化了构建过程通过声明式配置管理依赖关系让开发者能够专注于代码开发。2. 下载 Maven2.1 访问官方网站首先访问 Apache Maven 的官方网站官网地址https://maven.apache.org/2.2 选择下载版本在官网首页找到 “Download” 链接并点击进入下载页面后你会看到最新的稳定版本如 Maven 3.9.x选择适合你操作系统的二进制压缩包Windows 用户下载apache-maven-3.x.x-bin.zipmacOS/Linux 用户下载apache-maven-3.x.x-bin.tar.gz2.3 镜像站点加速如果官网下载速度较慢可以使用国内镜像站点阿里云镜像https://mirrors.aliyun.com/apache/maven/maven-3/华为云镜像https://mirrors.huaweicloud.com/apache/maven/3. 安装 Maven3.1 Windows 系统安装步骤步骤 1解压文件将下载的apache-maven-3.x.x-bin.zip文件解压到你喜欢的目录例如C:\Program Files\apache-maven-3.x.x步骤 2配置环境变量右键点击“此电脑” → “属性” → “高级系统设置” → “环境变量”在“系统变量”中新建变量变量名MAVEN_HOME变量值C:\Program Files\apache-maven-3.x.x你的实际解压路径编辑Path变量在末尾添加%MAVEN_HOME%\bin步骤 3验证安装打开命令提示符CMD或 PowerShell输入mvn-v如果显示 Maven 版本信息说明安装成功。3.2 macOS/Linux 系统安装步骤步骤 1解压文件打开终端进入下载目录执行解压命令# 对于 .tar.gz 文件tar-xzfapache-maven-3.x.x-bin.tar.gz# 移动解压后的文件夹到合适位置sudomvapache-maven-3.x.x /usr/local/步骤 2配置环境变量编辑 shell 配置文件根据你的 shell 选择# 对于 bashnano~/.bashrc# 对于 zshnano~/.zshrc在文件末尾添加exportMAVEN_HOME/usr/local/apache-maven-3.x.xexportPATH$MAVEN_HOME/bin:$PATH使配置生效source~/.bashrc# 或 source ~/.zshrc步骤 3验证安装在终端中输入mvn-v应该显示 Maven 版本信息。4. 配置 Maven 镜像加速4.1 修改 Maven 配置文件找到 Maven 安装目录下的conf/settings.xml文件在mirrors标签内添加阿里云镜像mirroridaliyunmaven/idmirrorOf*/mirrorOfname阿里云公共仓库/nameurlhttps://maven.aliyun.com/repository/public/url/mirror4.2 配置本地仓库位置可选如果你希望将 Maven 本地仓库放在其他位置可以在settings.xml中修改localRepositoryD:\maven-repository/localRepository5. 创建第一个 Maven 项目5.1 使用命令行创建项目打开终端或命令提示符执行mvn archetype:generate-DgroupIdcom.example-DartifactIdmy-first-app-DarchetypeArtifactIdmaven-archetype-quickstart-DinteractiveModefalse5.2 项目结构说明创建成功后你会看到以下目录结构my-first-app/ ├── pom.xml # 项目对象模型文件 ├── src/ │ ├── main/ │ │ └── java/ # 主代码目录 │ └── test/ │ └── java/ # 测试代码目录5.3 使用 IDE 图形界面创建项目可选除了命令行方式你也可以使用 IDE 的图形界面创建 Maven 项目这对于初学者更加直观。IntelliJ IDEA 创建 Maven 项目步骤打开 IntelliJ IDEA点击 “New Project”在左侧选择 “Maven”确保已选中 “Create from archetype”然后选择 “maven-archetype-quickstart”填写 GroupId如com.example和 ArtifactId如my-first-app选择项目存储位置点击 “Finish”[图IntelliJ IDEA 新建项目界面左侧选择 Maven中间显示 archetype 选择右侧填写 GroupId 和 ArtifactId]Eclipse 创建 Maven 项目步骤打开 Eclipse点击 “File” → “New” → “Other…”在弹出的对话框中展开 “Maven” 文件夹选择 “Maven Project”点击 “Next”在 “Select an Archetype” 页面勾选 “Create a simple project”点击 “Next”填写 GroupId、ArtifactId 和 Version点击 “Finish”[图Eclipse 新建 Maven 项目对话框显示 Maven Project 选项和 Archetype 选择页面]注意使用 IDE 创建项目时IDE 会自动生成标准的 Maven 项目结构与命令行创建的结果一致。5.4 编译和运行项目# 进入项目目录cdmy-first-app# 编译项目mvn compile# 运行测试mvntest# 打包项目mvn package6. 常见问题与解决方案问题 1mvn -v命令不识别解决方案检查环境变量配置是否正确确保MAVEN_HOME路径没有错误重启终端或命令提示符问题 2下载依赖超时解决方案检查网络连接配置镜像加速参考第 4 节使用 VPN 访问国外仓库问题 3Java 版本不兼容解决方案Maven 3.3 需要 Java 7 或更高版本使用java -version检查 Java 版本安装合适的 JDK 版本7. 进阶配置与优化7.1 配置 IDE 集成IntelliJ IDEAFile → Settings → Build, Execution, Deployment → Build Tools → MavenEclipseWindow → Preferences → MavenVS Code安装 “Maven for Java” 扩展7.2 性能优化建议增大内存在MAVEN_OPTS环境变量中设置-Xmx2048m -Xms1024m并行构建使用-T参数加速构建mvn cleaninstall-T4跳过测试在快速构建时跳过测试mvn cleaninstall-DskipTests8. 总结通过本指南你已经学会了✅ 从官网下载 Maven✅ 在 Windows/Mac/Linux 系统上安装 Maven✅ 配置环境变量和镜像加速✅ 创建和运行第一个 Maven 项目✅ 解决常见安装问题Maven 是 Java 开发中不可或缺的工具掌握它的安装和使用将为你的开发工作带来极大便利。建议在实际项目中多加练习熟悉 Maven 的各种命令和配置选项。下一步学习建议深入学习pom.xml文件的详细配置了解 Maven 的生命周期和插件机制学习使用 Maven 管理多模块项目