Maven 详细安装与配置教程：从下载到第一个项目构建

一、什么是 Maven？为什么 Java 开发者离不开它？

如果你写过 Java，一定遇到过这些问题：手动下载 jar 包、管理依赖地狱、编译打包步骤繁琐。Apache Maven 就是为了解决这些痛点而生的。

Maven 不仅仅是一个构建工具，更是一套完整的项目管理和依赖管理方案。你可以把它类比为 Python 的 pip + 虚拟环境，但它做的更多：统一项目结构、自动拉取依赖、多模块管理、一键打包部署。

核心概念速览：

• POM（Project Object Model）：项目的"身份证"，所有配置都写在一个 pom.xml 文件中，包括项目信息、依赖、插件等
• 依赖管理：声明需要的第三方库，Maven 自动从远程仓库下载到本地，无需手动拷贝 jar
• 构建生命周期：clean -> compile -> test -> package -> install，一条命令走到底
• 仓库体系：本地仓库 + 中央仓库（Maven Central）+ 自定义私服，层层缓存
• 约定优于配置：如果你遵循 Maven 默认的目录结构，很多配置可以直接省略

二、下载 Maven

推荐从官网下载最新稳定版：

Maven 官方下载页: https://maven.apache.org/download.cgi

Windows 用户下载 Binary zip 包（如 apache-maven-3.9.5-bin.zip），Linux/macOS 下载 tar.gz。

建议选择 -bin 版本，体量小、够用。-src 是源代码包，普通开发用不上。

三、安装与解压

Windows

将下载的 zip 解压到指定目录，例如：

C:\Program Files\Java\maven

目录结构如下：

maven/
  bin/           <- mvn 命令所在
  boot/          <- 类加载器
  conf/          <- 全局配置 setting.xml
  lib/           <- Maven 自身依赖

Linux / macOS

tar -zxvf apache-maven-3.9.5-bin.tar.gz
sudo mv apache-maven-3.9.5 /usr/local/maven

四、环境变量配置（关键步骤）

Windows

1. 右键「此电脑」-> 属性 -> 高级系统设置 -> 环境变量

2. 新建系统变量：

3. 在系统变量 Path 中新增：%MAVEN_HOME%\bin

Linux / macOS

编辑 ~/.bashrc 或 ~/.zshrc：

export MAVEN_HOME=/usr/local/maven
export PATH=$MAVEN_HOME/bin:$PATH

执行 source ~/.bashrc 使其生效。

五、验证安装

打开终端或 CMD，输入：

mvn -v

看到类似以下输出说明安装成功：

Apache Maven 3.9.5

Maven home: /usr/local/maven

Java version: 17.0.9

六、进阶配置

6.1 配置阿里云镜像（提速必备）

Maven Central 默认在国外，国内下载速度感人。编辑 conf/settings.xml，在 标签内添加：

  aliyunmaven
  central
  阿里云公共仓库
  https://maven.aliyun.com/repository/public

这样所有 central 仓库的请求都会走阿里云镜像，下载速度快 10 倍以上。

6.2 修改本地仓库位置

默认本地仓库在 C:\Users\用户名\.m2\repository（C 盘），建议改到其他盘：

D:\maven\mvnRespo

别忘先在 D 盘创建 maven\mvnRespo 文件夹。

七、常用命令速查表

八、创建第一个 Maven 项目

使用命令行快速生成项目骨架：

mvn archetype:generate   -DgroupId=com.example   -DartifactId=hello-maven   -DarchetypeArtifactId=maven-archetype-quickstart   -DinteractiveMode=false

生成后的目录结构：

hello-maven/
  pom.xml
  src/
    main/java/com/example/App.java
    test/java/com/example/AppTest.java

进入目录，编译 + 运行：

cd hello-maven
mvn compile
mvn exec:java -Dexec.mainClass="com.example.App"

看到 Hello World! 就说明一切就绪！

总结

Maven 的核心理念是约定优于配置——只要你按它的规则来，构建、测试、打包全部自动搞定。配合阿里云镜像和 IDE（IDEA/Eclipse）内置 Maven 支持，Java 开发效率能提升不止一个档次。

三个关键点记住就行：

1. pom.xml 是你的项目说明书

2. 镜像 能让你告别下载等待

3. mvn clean install 一行命令搞定构建

动手试试，你会发现 Maven 比想象中简单得多。

本文为作者原创，未经授权禁止转载、洗稿、搬运。如需引用请保留原文链接。