Windows 下 Maven 安装与配置完全指南

平平无奇程序员
40 阅读4分钟

Windows 下 Maven 安装与配置完全指南

Apache Maven 是 Java 项目管理和构建自动化工具，几乎成为 Java 开发的标准配置。本文将详细介绍在 Windows 系统下如何安装 Maven 并正确配置环境变量。

一、Maven 简介

Maven 是一个项目管理和构建工具，主要功能包括：

  • 项目结构标准化
  • 依赖管理（通过 pom.xml）
  • 构建生命周期管理
  • 插件系统

二、安装前准备

在安装 Maven 前，请确保已经完成以下准备工作：

  1. 已安装 JDK（Java Development Kit）
  2. 已配置 JAVA_HOME 环境变量
  3. 确保 Java 环境可用（在命令行执行 java -version 能正确显示版本）

三、Maven 下载与安装

1. 下载 Maven

  1. 访问 Maven 官网下载页面
  2. 选择最新稳定版本的 Binary zip archive 下载（例如：apache-maven-3.8.6-bin.zip）

注意：推荐下载二进制版本（bin.zip），而非源代码版本（src.zip）

2. 安装 Maven

Maven 是绿色软件，无需安装程序，只需解压即可使用：

  1. 将下载的 zip 文件解压到你选择的目录，例如：

    • C:\Program Files\apache-maven-3.8.6

  2. 建议目录路径中不要包含空格和中文，避免潜在问题

四、配置环境变量

1. 配置 MAVEN_HOME

  1. 右键点击 "此电脑" → "属性" → "高级系统设置" → "环境变量"
  2. 在 "系统变量" 区域点击 "新建"
  3. 变量名输入 MAVEN_HOME
  4. 变量值输入 Maven 的解压路径，例如：C:\Program Files\apache-maven-3.8.6
  5. 点击 "确定" 保存

2. 配置 Path 变量

  1. 在 "系统变量" 中找到 "Path" 变量并双击

  2. 点击 "新建"，添加以下路径：

    • %MAVEN_HOME%\bin

  3. 点击 "确定" 保存所有设置

3. 验证安装

打开新的命令提示符窗口（重要：必须新开窗口才能使环境变量生效），执行：

bash

mvn -v

如果正确显示 Maven 版本信息、Java 版本和 JAVA_HOME 路径，说明配置成功。

示例输出：

text

Apache Maven 3.8.6 (xxxxxx)
Maven home: C:\Program Files\apache-maven-3.8.6
Java version: 11.0.15, vendor: AdoptOpenJDK, runtime: C:\Program Files\AdoptOpenJDK\jdk-11.0.11.9-hotspot
Default locale: zh_CN, platform encoding: GBK
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"

五、配置 Maven 本地仓库

Maven 会下载依赖到本地仓库，默认位置在用户目录下的 .m2 文件夹。我们可以自定义这个位置：

  1. 在 Maven 安装目录的 conf 子目录中找到 settings.xml 文件

    • 例如：C:\Program Files\apache-maven-3.8.6\conf\settings.xml

  2. 找到 <localRepository> 标签（默认被注释），取消注释并修改为你的路径：

xml

<localRepository>D:\maven_repository</localRepository>
  1. 保存文件

提示：建议将本地仓库放在非系统盘，且路径不要包含中文和空格

六、配置镜像加速

为了加快依赖下载速度，可以配置国内镜像：

在 settings.xml 中找到 <mirrors> 部分，添加阿里云镜像：

xml

<mirror>
  <id>aliyunmaven</id>
  <mirrorOf>*</mirrorOf>
  <name>阿里云公共仓库</name>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>

七、IDE 集成

1. IntelliJ IDEA 配置

  1. 打开 File → Settings → Build, Execution, Deployment → Build Tools → Maven
  2. 设置 Maven home path 为你的 Maven 安装目录
  3. 设置 User settings file 为修改过的 settings.xml
  4. 设置 Local repository 为你配置的本地仓库路径

2. Eclipse 配置

  1. 打开 Window → Preferences → Maven
  2. 设置 Installation → Add 你的 Maven 安装目录
  3. 设置 User Settings 为你的 settings.xml 文件路径

八、常见问题解决

  1. 'mvn' 不是内部或外部命令

    • 检查 MAVEN_HOME 是否配置正确
    • 检查 Path 中是否包含 %MAVEN_HOME%\bin
    • 确保是在新打开的命令行窗口测试

  2. 构建时下载依赖失败

    • 检查网络连接
    • 确认镜像配置正确
    • 尝试删除本地仓库中对应依赖的文件夹后重新构建

  3. 版本不兼容问题

    • Maven 3.3+ 需要 JDK 1.7 或更高版本
    • 检查 JAVA_HOME 指向的 JDK 版本是否符合要求

九、Maven 基本使用

验证安装成功后，可以尝试以下命令：

  • 创建新项目：

    bash

    mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

  • 编译项目：

    bash

    mvn compile

  • 打包项目：

    bash

    mvn package

  • 清理项目：

    bash

    mvn clean

结语

通过以上步骤，你已经成功在 Windows 系统上安装并配置了 Maven 环境。Maven 的强大功能将极大提升你的 Java 开发效率。建议进一步学习 pom.xml 文件编写和 Maven 生命周期，以充分发挥 Maven 的优势。

如果在安装过程中遇到任何问题，欢迎在评论区留言讨论！

avatar
文章
阅读
粉丝