Windows 配置 Maven 环境变量详细教程

发表于 2025-08-09 13:41:04 分类于 默认分类 阅读量 236

Windows 配置 Maven 环境变量详细教程

Maven 是 Java 项目管理和构建的强大工具,配置好环境变量是使用 Maven 的第一步。本文将详细介绍如何在 Windows 系统上配置 Maven 环境变量。


1. 下载与安装 Maven

  1. 访问 Maven 官方下载页面:https://maven.apache.org/download.cgi
  2. 下载 Binary zip archive 版本,例如:apache-maven-3.9.9-bin.zip
  3. 解压到你希望安装的位置,例如:

C:\Program Files\Apache\Maven\\

  1. 解压后目录结构类似:

C:\Program Files\Apache\Maven\apache-maven-3.9.9
├── bin
├── boot
├── conf
└── lib


2. 配置环境变量

2.1 新建 MAVEN_HOME 系统变量

  1. 右键“此电脑” → 选择“属性” → 点击“高级系统设置” → 点击“环境变量”
  2. 在“系统变量”区域点击 新建,输入:
  • 变量名:MAVEN_HOME
  • 变量值:C:\Program Files\Apache\Maven\apache-maven-3.9.9 (你的 Maven 安装路径)

2.2 修改 Path 变量

  1. 找到系统变量中的 Path,点击编辑
  2. 点击新建,添加以下内容:

%MAVEN\_HOME%\bin

2.3 配置 Java 环境变量(确保已安装 JDK)

Maven 依赖 Java 运行环境,确保配置了 Java 环境变量:

  1. 新建系统变量:
  • 变量名:JAVA_HOME
  • 变量值:JDK 安装路径,例如 C:\Program Files\Java\jdk-17
  1. Path 变量中添加:

%JAVA\_HOME%\bin


3. 验证 Maven 是否安装成功

  1. 打开命令提示符(CMD),输入:
mvn -v
  1. 若显示类似以下信息,则配置成功:

    Apache Maven 3.9.9 ( ... )
    Java version: 17.0.10, vendor: Oracle Corporation
    

注意事项

  • Maven 和 JDK 安装路径建议不要包含空格或中文,避免出现奇怪的问题。
  • 修改环境变量后,需重新打开命令行窗口或重启电脑,确保变量生效。
  • Maven 本地仓库默认在 C:\Users\你的用户名\.m2\repository,可以通过修改 conf/settings.xml 配置文件自定义本地仓库路径。

总结

配置 Maven 环境变量步骤其实很简单,关键是路径要对,环境变量要设置完整。配置好后,在命令行使用 mvn -v 检查即可确认。希望本文能帮你快速搞定 Maven 环境配置!