Maven从入门到配置国内镜像，别再卡在下载了

嘿，来了。

今天聊聊Maven。

这玩意儿吧，说难不难，说简单吧，新手第一次用真的会一脸懵。

我记得有个同学找我，说项目跑不起来，报一堆红。我远程一看，Maven没配，jar包一个都没下下来。他说：“我以为装完IDEA就能用啊。”

嗯，很多人都这么以为。

所以今天咱把这坑填上。你跟着我走，Maven装好、配好、镜像换上，以后下载jar包嗖嗖的。

一、Maven是干啥的？

先不说那些官方定义，我用大白话跟你说：

Maven就是个管jar包的工具。

你写Java项目，是不是经常要引这个依赖、那个依赖？没有Maven的时候，你得自己去网上搜jar包，下载，放到项目里，还怕版本不对。

有了Maven，你在配置文件里写一行代码，它就自动给你下载好、放好、管理好。

打个比方：Maven像个外卖小哥。你点菜（写依赖），他给你送过来（下载jar包），还帮你摆好（放到正确位置）。

懂了不？

二、Maven下载

去官网下，地址搜“Maven download”就行。

下载地址：https://maven.apache.org/download.cgi

找那个apache-maven-3.x.x-bin.zip，点下载。

💡 版本选3.8或者3.9都行，别选太老的就行。现在稳定版一般是3.9.x。

下完了是一个压缩包，解压。

重要：解压路径不要有中文，不要有空格。

比如解压到：D:\apache-maven-3.9.9（具体版本号看你下的哪个）

别解压到D:\我的软件\Maven这种带中文的，后面会出莫名其妙的毛病。

三、配置环境变量

这一步很多人卡住，其实不复杂。我给你掰开揉碎说。

第1步： 右键此电脑 → 属性

第2步： 点高级系统设置 → 点环境变量

第3步： 在系统变量那里，点新建

弹出来一个框，填：

· 变量名：MAVEN_HOME

· 变量值：你解压的那个路径，比如D:\apache-maven-3.9.9

点确定。

第4步： 找到Path，双击

点新建，输入：%MAVEN_HOME%\bin

点确定确定确定，一路保存。

第5步： 验证一下

按Win + R，输入cmd，回车。

在黑框里输入：

mvn -v

回车。

如果蹦出来一堆Maven的版本信息，恭喜你，装好了。

如果提示“‘mvn’不是内部或外部命令”，那就是环境变量没配好，回去检查一下路径对不对。

四、配置国内镜像（最关键的一步）

这一步不配，你下载jar包会非常非常慢。

为啥？因为Maven默认的中央仓库在国外，网速慢得跟蜗牛似的。

配了国内镜像，就换成国内的服务器下载，快很多。

操作步骤：

第1步： 找到Maven的settings.xml文件

在你解压的Maven目录里，进conf文件夹，里面有一个settings.xml。

用记事本或者IDEA打开它。

第2步： 找到<mirrors>标签

在这个文件里搜索<mirrors>，如果找到了，就在它里面加内容。

如果没找到，自己写一个：

<mirrors>
    <!-- 阿里云镜像 -->
    <mirror>
        <id>aliyunmaven</id>
        <mirrorOf>central</mirrorOf>
        <name>阿里云公共仓库</name>
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
</mirrors>

第3步： 保存

完事了。

补充一个： 有些教程会让你改好几个镜像，其实不用。阿里云这一个就够用了，又快又稳。

⚠️ 注意：settings.xml里的格式不能乱，标签要成对出现。你要是拿不准，就搜一下“Maven settings.xml模板”，或者公众号回复【Maven】我发你一份现成的。

五、在IDEA里配置Maven

Maven装好了，镜像配好了，最后一步是在IDEA里告诉它：用我这个Maven，别用自带的。

第1步： 打开IDEA，进设置

File → Settings（或者快捷键Ctrl+Alt+S）

第2步： 搜Maven

左边找到Build, Execution, Deployment → Build Tools → Maven

第3步： 改三个地方：

配置项	改成什么
Maven home path	你解压的路径，比如D:\apache-maven-3.9.9
User settings file	勾选Override，然后选你改过的settings.xml
Local repository	本地仓库路径，可以不改（默认在C盘用户目录下的.m2文件夹里）

如果你不想把jar包都塞C盘，可以改一下Local repository，比如改成D:\maven-repo

第4步： 点Apply，点OK

第5步： 让IDEA重新加载一下

右下角会弹一个提示，点那个刷新按钮（或者点Load Maven Changes），等它下载完。

六、验证一下好不好使

第1步： 新建一个Spring Boot项目（或者随便一个Maven项目）

第2步： 在pom.xml里随便加一个依赖，比如：​​​​​​

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

第3步： 点刷新

看IDEA右下角的进度条，如果jar包嗖嗖地往下下，不卡顿，说明镜像配成功了。

如果不放心，可以打开你设置的本地仓库文件夹，里面应该会多出来一堆文件夹，那就是下载下来的jar包。

七、常见翻车现场

1、“mvn -v 提示不是内部命令”

环境变量没配好。回去检查MAVEN_HOME和Path，看看路径对不对，有没有把bin目录加进去。

2、“下载jar包还是很慢”

镜像没配上。检查一下settings.xml里的<url>对不对，阿里云镜像地址是不是https://maven.aliyun.com/repository/public

3、“IDEA提示找不到依赖”

可能是IDE缓存的问题。试试File → Invalidate Caches / Restart，清一下缓存重启。

4、“settings.xml改完报错”

大概率是XML格式不对，标签没关或者多打了符号。你可以找个在线XML验证工具贴进去检查一下。

5、“下载到一半卡住了”

删掉本地仓库里下载了一半的文件夹（一般在.m2/repository下），重新刷一下让它重新下。

八、顺便说一下

Maven搞定了，以后你开发Java项目会顺手很多。

依赖管理、项目构建、打包部署，都用得着它。

如果你想把本地仓库改成D盘（不想占C盘空间），可以这样搞：

在settings.xml里找一个叫<localRepository>的标签，默认是被注释掉的。解开注释，把路径改成你想要的，比如：

<localRepository>D:/maven-repo</localRepository>

注意斜杠是/，不是Windows默认的\，虽然两个都能用，但建议用/，省得转义出问题。

完事了

看到这儿，你应该已经把Maven搞定了。

环境配好、镜像换好、IDEA设置好，以后下载jar包再也不用等半天了。

配置过程中有啥问题，公众号直接发消息问我。我看到就回。

安装包去哪儿拿？

关注「已经码好了」，回复【Maven】，我把下载链接和settings.xml配置文件发你，你直接替换就能用。