Maven 是 Java 项目主流的项目管理与构建工具，能够帮我们自动管理项目依赖包、统一项目结构、打包编译，大幅简化 Java 开发流程。很多新手初次接触 Maven 时，经常卡在下载、环境变量配置环节，出现命令找不到、版本不兼容等问题。本篇教程从零出发，手把手演示 Maven 下载、安装、环境变量配置、本地仓库以及国内镜像设置，全程附带验证方法，跟着操作就能一次配置成功。

前置条件：Maven 运行依赖 JDK，配置 Maven 前请先完成 JDK 的安装与环境变量配置，推荐 JDK8 及以上版本。

一、Maven 下载

1. 打开 Maven 官方下载地址，进入下载页面，选择 Binary zip archive 二进制压缩包（源码包无需下载），后缀为 .zip（Windows系统）。

提示：优先选择稳定发行版，不要选用预览版，避免出现未知兼容性问题。

1. 下载完成后，将压缩包解压到非中文、无空格的目录。 ✅ 推荐示例路径：D:\apache-maven-3.9.6 ❌ 不推荐：D:\软件\maven、D:\apache maven（中文、空格会引发异常） 解压完成后，进入maven根目录，确认内部包含 bin、conf 文件夹，说明解压正常。

二、Windows 系统配置环境变量

1. 新建MAVEN_HOME变量

1. 右键【此电脑】→【属性】→【高级系统设置】→【环境变量】
2. 在系统变量区域，点击【新建】

• 变量名：MAVEN_HOME
• 变量值：填写刚才解压的maven根目录，例如 D:\apache-maven-3.9.6

1. 点击确定保存。

2. 配置Path变量

1. 在系统变量中找到 Path，双击编辑
2. 点击【新建】，填入 %MAVEN_HOME%\bin
3. 依次点击确定，保存全部环境变量窗口。

注意：环境变量配置完成后， 必须关闭已经打开的CMD窗口，重新打开新终端，旧终端不会加载新配置。

三、验证Maven是否安装成功

打开 cmd 命令提示符，输入命令：

mvn -v

如果输出 Maven 版本、Java版本、本地仓库地址等信息，代表环境变量配置成功。 若提示 'mvn' 不是内部或外部命令，排查方向：

1. 检查 MAVEN_HOME 路径是否填写错误
2. Path 配置是否正确
3. 是否没有重启cmd终端
4. 压缩包解压路径是否含有中文或空格

四、配置本地仓库与国内镜像（核心优化）

默认情况下，Maven会把下载的jar包存放在C盘用户目录下，长时间使用会占用大量C盘空间，并且国外官方源下载速度极慢，所以我们需要修改配置文件 settings.xml。

1. 设置本地仓库

找到 maven/conf/settings.xml 文件，用记事本或者VS Code打开。 找到 <localRepository> 配置项，取消注释，修改为自定义仓库路径：

<localRepository>D:\maven-repository</localRepository>

D:\maven-repository 文件夹需要手动提前创建。

2. 配置国内阿里云镜像

在 settings.xml 文件的 <mirrors> 标签内部，添加阿里云镜像配置，替换国外源，提升依赖下载速度：

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

添加完成后保存文件。

五、测试Maven拉取依赖

新开CMD，执行命令创建简单项目验证：

mvn archetype:generate

首次运行会自动从阿里云镜像下载基础依赖包，等待下载完成，能正常生成项目骨架，说明镜像与仓库配置全部生效。

六、常见问题汇总

1. mvn -v 报错 JAVA_HOME 不存在 Maven 读取JDK依靠JAVA_HOME环境变量，检查JDK环境变量是否配置。
2. 下载依赖包超时、卡住 检查镜像配置是否粘贴到正确标签内，确认网络可以访问阿里云maven地址。
3. 依赖包下载一半损坏 进入本地仓库对应目录，删除损坏的文件，重新执行mvn命令重新下载。

结尾

到这里，Maven 的下载、安装、环境变量、本地仓库、国内镜像全部配置完毕。配置好Maven之后，就可以在IDEA、Eclipse等开发工具中关联这个Maven，用来管理Java Web、SpringBoot等项目的依赖。掌握Maven基础配置，是Java后端开发入门的必备技能。

https://content.mtime.com/post/229725648

https://content.mtime.com/post/229725817

https://content.mtime.com/post/229725823

https://content.mtime.com/post/229725832

https://content.mtime.com/post/229725841

https://content.mtime.com/post/229725848

https://content.mtime.com/post/229725854

https://content.mtime.com/post/229725862

https://content.mtime.com/post/229725867

https://content.mtime.com/post/229725873

https://content.mtime.com/post/229725880

https://content.mtime.com/post/229725887

https://content.mtime.com/post/229726003

https://content.mtime.com/post/229726009

https://content.mtime.com/post/229726016

https://content.mtime.com/post/229726022

https://content.mtime.com/post/229726027

https://content.mtime.com/post/229726035

https://content.mtime.com/post/229726040

https://content.mtime.com/post/229726047

https://content.mtime.com/post/229726053

https://content.mtime.com/post/229726060

https://content.mtime.com/post/229726067

https://content.mtime.com/post/229726073

https://content.mtime.com/post/229726081

https://content.mtime.com/post/229726087

https://content.mtime.com/post/229726093

https://content.mtime.com/post/229726099

https://content.mtime.com/post/229726206

https://content.mtime.com/post/229726212

https://content.mtime.com/post/229726219

https://content.mtime.com/post/229726225

https://content.mtime.com/post/229726231

https://content.mtime.com/post/229726237

https://content.mtime.com/post/229726243

https://content.mtime.com/post/229726249

https://content.mtime.com/post/229726257

https://content.mtime.com/post/229726263

https://content.mtime.com/post/229726268

https://content.mtime.com/post/229726275

https://content.mtime.com/post/229726281

https://content.mtime.com/post/229726287

https://content.mtime.com/post/229726298

https://content.mtime.com/post/229726405

https://content.mtime.com/post/229726411

https://content.mtime.com/post/229726425

https://content.mtime.com/post/229726434

https://content.mtime.com/post/229726439

https://content.mtime.com/post/229726445

https://content.mtime.com/post/229726451

https://content.mtime.com/post/229726457

https://content.mtime.com/post/229726462

https://content.mtime.com/post/229726468

https://content.mtime.com/post/229726479

https://content.mtime.com/post/229726485

https://content.mtime.com/post/229726492

https://content.mtime.com/post/229726497

https://content.mtime.com/post/229726602

https://content.mtime.com/post/229726608

https://content.mtime.com/post/229726623

https://content.mtime.com/post/229726629

https://content.mtime.com/post/229726634

https://content.mtime.com/post/229726641

https://content.mtime.com/post/229726647

https://content.mtime.com/post/229726652

https://content.mtime.com/post/229726657

https://content.mtime.com/post/229726663

https://content.mtime.com/post/229726670

https://content.mtime.com/post/229726676

https://content.mtime.com/post/229726681

https://content.mtime.com/post/229726691

https://content.mtime.com/post/229726698

https://content.mtime.com/post/229726803

https://content.mtime.com/post/229726808

https://content.mtime.com/post/229726822

https://content.mtime.com/post/229726827

https://content.mtime.com/post/229726839

https://content.mtime.com/post/229726845

https://content.mtime.com/post/229726850

https://content.mtime.com/post/229726855

https://content.mtime.com/post/229726862

https://content.mtime.com/post/229726867

https://content.mtime.com/post/229726872

https://content.mtime.com/post/229726885

https://content.mtime.com/post/229726890

https://content.mtime.com/post/229726895

https://content.mtime.com/post/229727001

https://content.mtime.com/post/229727011

https://content.mtime.com/post/229727016

https://content.mtime.com/post/229727023

https://content.mtime.com/post/229727029

https://content.mtime.com/post/229727034

https://content.mtime.com/post/229727040

https://content.mtime.com/post/229727047

https://content.mtime.com/post/229727051

https://content.mtime.com/post/229727064

https://content.mtime.com/post/229727070

https://content.mtime.com/post/229727076

https://content.mtime.com/post/229727080

https://content.mtime.com/post/229727087

https://content.mtime.com/post/229727094

https://content.mtime.com/post/229727200

https://content.mtime.com/post/229727204

https://content.mtime.com/post/229727217

https://content.mtime.com/post/229727222

https://content.mtime.com/post/229727227

https://content.mtime.com/post/229727234

https://content.mtime.com/post/229727241

https://content.mtime.com/post/229727247

https://content.mtime.com/post/229727252

https://content.mtime.com/post/229727257

https://content.mtime.com/post/229727264

https://content.mtime.com/post/229727276

https://content.mtime.com/post/229727282

https://content.mtime.com/post/229727289

https://content.mtime.com/post/229727294

https://content.mtime.com/post/229727299

https://content.mtime.com/post/229727405

https://content.mtime.com/post/229727413

https://content.mtime.com/post/229727418

https://content.mtime.com/post/229727423

https://content.mtime.com/post/229727429

https://content.mtime.com/post/229727436

https://content.mtime.com/post/229727442

https://content.mtime.com/post/229727448

https://content.mtime.com/post/229727453

https://content.mtime.com/post/229727460

https://content.mtime.com/post/229727465

https://content.mtime.com/post/229727483

https://content.mtime.com/post/229727489

https://content.mtime.com/post/229727494

https://content.mtime.com/post/229727600

https://content.mtime.com/post/229727607

https://content.mtime.com/post/229727612

https://content.mtime.com/post/229727623

https://content.mtime.com/post/229727630

https://content.mtime.com/post/229727636

https://content.mtime.com/post/229727640

https://content.mtime.com/post/229727646

https://content.mtime.com/post/229727654

https://content.mtime.com/post/229727663

https://content.mtime.com/post/229727669

https://content.mtime.com/post/229727680

https://content.mtime.com/post/229727698

https://content.mtime.com/post/229727805

https://content.mtime.com/post/229727812

https://content.mtime.com/post/229727817

https://content.mtime.com/post/229727822

https://content.mtime.com/post/229727829

https://content.mtime.com/post/229727834

https://content.mtime.com/post/229727841

https://content.mtime.com/post/229727847

https://content.mtime.com/post/229727853

https://content.mtime.com/post/229727859

https://content.mtime.com/post/229727864

https://content.mtime.com/post/229727870

https://content.mtime.com/post/229727882

https://content.mtime.com/post/229727887

https://content.mtime.com/post/229727897

https://content.mtime.com/post/229728004

https://content.mtime.com/post/229728008

https://content.mtime.com/post/229728015

https://content.mtime.com/post/229728021

https://content.mtime.com/post/229728028

https://content.mtime.com/post/229728038

https://content.mtime.com/post/229728044

https://content.mtime.com/post/229728059

https://content.mtime.com/post/229728065

https://content.mtime.com/post/229728065

https://content.mtime.com/post/229728076

https://content.mtime.com/post/229728081

https://content.mtime.com/post/229728087

https://content.mtime.com/post/229728093

https://content.mtime.com/post/229728200

https://content.mtime.com/post/229728200

https://content.mtime.com/post/229728215

https://content.mtime.com/post/229728221

https://content.mtime.com/post/229728233

https://content.mtime.com/post/229728239

https://content.mtime.com/post/229728243

https://content.mtime.com/post/229728243

https://content.mtime.com/post/229728260

https://content.mtime.com/post/229728266

https://content.mtime.com/post/229728272

https://content.mtime.com/post/229728277

https://content.mtime.com/post/229728293

https://content.mtime.com/post/229728400

https://content.mtime.com/post/229728407

https://content.mtime.com/post/229728411

https://content.mtime.com/post/229728417

https://content.mtime.com/post/229728423

https://content.mtime.com/post/229728430

https://content.mtime.com/post/229728437

https://content.mtime.com/post/229728437

https://content.mtime.com/post/229728446

https://content.mtime.com/post/229728452

https://content.mtime.com/post/229728459

https://content.mtime.com/post/229728484

https://content.mtime.com/post/229728490

https://content.mtime.com/post/229728605

https://content.mtime.com/post/229728610

https://content.mtime.com/post/229728616

https://content.mtime.com/post/229728634

https://content.mtime.com/post/229728640

https://content.mtime.com/post/229728666

https://content.mtime.com/post/229728675

https://content.mtime.com/post/229728695

https://content.mtime.com/post/229728801

https://content.mtime.com/post/229728806

https://content.mtime.com/post/229728806

https://content.mtime.com/post/229728815

https://content.mtime.com/post/229728821

https://content.mtime.com/post/229728884

https://content.mtime.com/post/229728889

https://content.mtime.com/post/229728895

https://content.mtime.com/post/229729002

https://content.mtime.com/post/229729007

https://content.mtime.com/post/229729014

https://content.mtime.com/post/229729019

https://content.mtime.com/post/229729030

https://content.mtime.com/post/229729037

https://content.mtime.com/post/229729044

https://content.mtime.com/post/229729049

https://content.mtime.com/post/229729055

https://content.mtime.com/post/229729061

https://content.mtime.com/post/229729067

https://content.mtime.com/post/229729074

https://content.mtime.com/post/229729079

https://content.mtime.com/post/229729091

https://content.mtime.com/post/229729096

https://content.mtime.com/post/229729201

https://content.mtime.com/post/229729207

https://content.mtime.com/post/229729214

https://content.mtime.com/post/229729220

https://content.mtime.com/post/229729226

https://content.mtime.com/post/229729237

https://content.mtime.com/post/229729244

https://content.mtime.com/post/229729249

https://content.mtime.com/post/229729255

https://content.mtime.com/post/229729261

https://content.mtime.com/post/229729267

https://content.mtime.com/post/229729273

https://content.mtime.com/post/229729281

https://content.mtime.com/post/229729286

https://content.mtime.com/post/229729291

https://content.mtime.com/post/229729409

https://content.mtime.com/post/229729415

https://content.mtime.com/post/229729420

https://content.mtime.com/post/229729427

https://content.mtime.com/post/229729442

https://content.mtime.com/post/229729450

https://content.mtime.com/post/229729455

https://content.mtime.com/post/229729465

https://content.mtime.com/post/229729472

https://content.mtime.com/post/229729478

https://content.mtime.com/post/229729494

https://content.mtime.com/post/229729600

https://content.mtime.com/post/229729614

https://content.mtime.com/post/229729619

https://content.mtime.com/post/229729630

https://content.mtime.com/post/229729636

https://content.mtime.com/post/229729643

https://content.mtime.com/post/229729648

https://content.mtime.com/post/229729654

https://content.mtime.com/post/229729660

https://content.mtime.com/post/229729666

https://content.mtime.com/post/229729683

https://content.mtime.com/post/229729688

https://content.mtime.com/post/229729694

https://content.mtime.com/post/229729800

https://content.mtime.com/post/229729812

https://content.mtime.com/post/229729818

https://content.mtime.com/post/229729824

https://content.mtime.com/post/229729829

https://content.mtime.com/post/229729841

https://content.mtime.com/post/229729848

https://content.mtime.com/post/229729853

https://content.mtime.com/post/229729863

https://content.mtime.com/post/229729870

https://content.mtime.com/post/229729876

https://content.mtime.com/post/229729882

https://content.mtime.com/post/229729894

https://content.mtime.com/post/229730000

https://content.mtime.com/post/229730010

https://content.mtime.com/post/229730031

https://content.mtime.com/post/229730047

https://content.mtime.com/post/229730053

https://content.mtime.com/post/229730060

https://content.mtime.com/post/229730081

https://content.mtime.com/post/229730087

https://content.mtime.com/post/229730093

https://content.mtime.com/post/229730203

https://content.mtime.com/post/229730220

https://content.mtime.com/post/229730225

https://content.mtime.com/post/229730231

https://content.mtime.com/post/229730238

https://content.mtime.com/post/229730244

https://content.mtime.com/post/229730250

https://content.mtime.com/post/229730255

https://content.mtime.com/post/229730262

https://content.mtime.com/post/229730262

https://content.mtime.com/post/229730273

https://content.mtime.com/post/229730278

https://content.mtime.com/post/229730285

https://content.mtime.com/post/229730290

https://content.mtime.com/post/229730297

https://content.mtime.com/post/229730402

https://content.mtime.com/post/229730409

https://content.mtime.com/post/229730424

https://content.mtime.com/post/229730451

https://content.mtime.com/post/229730479

https://content.mtime.com/post/229730490

https://content.mtime.com/post/229730496

https://content.mtime.com/post/229730601

https://content.mtime.com/post/229730609

https://content.mtime.com/post/229730615

https://content.mtime.com/post/229730624

https://content.mtime.com/post/229730636

https://content.mtime.com/post/229730643

https://content.mtime.com/post/229730649

https://content.mtime.com/post/229730660

https://content.mtime.com/post/229730665

https://content.mtime.com/post/229730670

https://content.mtime.com/post/229730683

https://content.mtime.com/post/229730689

https://content.mtime.com/post/229730694

https://content.mtime.com/post/229730699

https://content.mtime.com/post/229730821

https://content.mtime.com/post/229730827

https://content.mtime.com/post/229730837

https://content.mtime.com/post/229730844

https://content.mtime.com/post/229730859

https://content.mtime.com/post/229730864

https://content.mtime.com/post/229730870

https://content.mtime.com/post/229730877