Maven 下载、安装与配置:一次跑通,顺路把坑填了

04

—

Maven 配置

Maven 的核心配置文件settings.xml ，Maven的配置基本都集中在这个文件中，它有两份：

• 全局（安装目录下）：我这里是 D:\software\Maven\apache-maven-3.9.14\conf\settings.xml

• 用户级：C:\Users\用户名\.m2\settings.xml（第一次安装，你的用户目录下可能连.m2这个目录都没有，这是正常的，后面自己创建就是）

这两份配置文件都能会被 Maven 读取，但是用户级的配置优先级更高（即出现相同配置，用户级的会覆盖全局的），所以我的做法是直接将全局的settings.xml配置文件直接复制一份到 C:\Users\用户名\.m2\下（没有.m2目录，手动创建就是），就只修改用户级别的配置。因为以后你升级Maven，你的全局配置又得重新配置，用户级别的，只要用户不变，配置就不变

所以接下来就对用户级的配置进行修改

1. 改本地仓库

本地仓库默认在 C:\Users\你的用户名\.m2\repository，用久了轻松几个 G，建议挪到别的盘

在 settings.xml 里找到被注释掉的 localRepository 那一行的下面，新增如下配置

<!-- 本地仓库 （注意仓库地址不要有中文）--><localRepository>D:\maven-repository</localRepository>

2. 换镜像源

官方中央仓库在国外，不换镜像的话，第一次拉依赖会慢到怀疑人生。在 <mirrors> 节点里加上阿里云的镜像：

其中需要注意：

• 新版的 settings.xml 里 没有注释的、叫maven-default-http-blocker 的mirror其实不用注释，它的作用是拦截http 协议的仓库，把它注释掉只会让你更容易撞上 http 仓库被拒的问题，留着就行。如果公司有私服（比如Nexus），在mirrorOf处要排除对私服的请求，不然无法请求私服的仓库（我本地没有私服，就不配置了）

<mirror>  <id>maven-default-http-blocker</id>  <mirrorOf>external:http:*,!私服id或私服的ip或域名</mirrorOf>  <name>Pseudo repository to mirror external repositories initially using HTTP.</name>  <url>http://0.0.0.0/</url>  <blocked>true</blocked></mirror>

<!-- mirrorOf 中写 central 表示只替换中央仓库。公司私服、Spring仓库都不受影响mirrorOf 中写 * 表示把所有仓库请求全部代理到阿里云，一但你项目里配了私服，而阿里云上又没有的话，就会报依赖找不到的错误所以mirrorOf 中建议配置为central--><mirror>  <id>aliyunmaven</id>  <mirrorOf>central</mirrorOf>  <name>阿里云公共仓库</name>  <url>https://maven.aliyun.com/repository/public</url></mirror>

<!-- jdk配置(可替换成你的jdk版本) --><profile>  <id>jdk21</id>  <activation>    <activeByDefault>true</activeByDefault>  </activation>  <properties>     <!-- 不推荐的写法 -->     <!--   	<maven.compiler.source>17</maven.compiler.source>    <maven.compiler.target>17</maven.compiler.target>	 -->     <!--官方推荐这种配置方式：比如这里配置的是jdk21的版本，但实际用的是jdk21+的版本进行编译，可以确保你的代码只使用jdk21及之前版本中存在的API，从根本上      避免了这种兼容性问题-->     <maven.compiler.release>21</maven.compiler.release>     <!-- 避免跨平台构建时出现乱码问题 -->    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>    <maven.compiler.encoding>UTF-8</maven.compiler.encoding>  </properties></profile>