如果您希望在Windows系统中使用Maven进行Java项目的构建与依赖管理，则需要完成Maven的安装、环境变量配置以及本地仓库镜像源的设置。以下是具体操作步骤：
一、下载并解压Maven二进制包
Apache Maven不提供安装程序，需手动下载ZIP压缩包并解压至本地目录。该方式避免注册表写入，便于多版本共存与路径控制。
1、访问Maven官方下载页面，在“Binary zip archive”区域选择最新稳定版（如apache-maven-3.9.7-bin.zip）。
2、将下载完成的ZIP文件解压到一个**不含中文和空格的路径**中，例如：D:\tools\apache-maven-3.9.7。
3、确认解压后目录中存在bin、conf、lib等子目录，且bin\mvn.cmd文件可执行。
二、配置系统环境变量
通过设置M2_HOME和更新PATH，使Windows命令行能全局识别mvn命令。此配置影响所有用户会话，需管理员权限生效。
1、右键“此电脑” → “属性” → “高级系统设置” → “环境变量”。
2、在“系统变量”区域点击“新建”，变量名为M2_HOME，变量值为Maven解压路径，例如：D:\tools\apache-maven-3.9.7。
3、在“系统变量”中找到Path，点击“编辑” → “新建”，添加：%M2_HOME%\bin。
4、打开新的命令提示符窗口，执行mvn -v，若显示Maven版本、Java版本及Maven主目录，则配置成功。
三、修改conf/settings.xml启用本地仓库与镜像源
Maven默认本地仓库位于C:\Users\用户名\.m2\repository，首次构建时会自动创建。通过修改settings.xml可指定自定义路径并配置国内镜像（如阿里云），显著提升依赖下载速度。
1、进入%M2_HOME%\conf\目录，复制settings.xml文件，在同一目录下粘贴并重命名为settings.xml.bak作为备份。
2、用文本编辑器（如Notepad++或VS Code）打开原settings.xml，定位到<localRepository>标签（默认被注释），取消注释并修改为自定义路径，例如：<localRepository>D:\m2\repository</localRepository>。
3、在<mirrors>标签内（位于<settings>根节点下）添加阿里云镜像配置：
<mirror>
<id>aliyunmaven</id>
<mirrorOf>*</mirrorOf>
<name>Aliyun Maven</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
四、验证本地仓库与镜像是否生效
通过创建最小化Maven项目并触发依赖下载，可验证本地仓库路径是否正确写入、镜像源是否被实际调用，避免因缓存或配置未加载导致误判。
1、在任意空目录下执行：mvn archetype:generate -DgroupId=com.example -DartifactId=demo-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false。
2、等待项目生成完成后，检查您在settings.xml中指定的localRepository路径（如D:\m2\repository）是否已创建，并出现com\example及org\apache\maven等目录结构。
3、观察控制台输出中的下载URL，确认其域名包含maven.aliyun.com而非repo.maven.apache.org。
评论(0)