Guide for Maven Installation & Build

一、Maven 的下载与安装

Maven 3.9.8 Windows版本下载链接

下载好后，解压到特定文件夹（路径不能有中文、空格和其他特殊字符）。

二、配置环境变量

打开系统环境变量。

修改 Path 内容，添加 Maven 安装路径。

环境变量配置好后，在终端中输入 mvn -v 查看 Maven 版本，验证是否安装成功。

三、配置 settings 和 toolchains 文件

打开Maven安装路径下 /conf/settings.xml 和 /conf/toolchains.xml 文件。

为了在 IDEA 中提高 Maven 的构建速度，需要修改 Maven 的下载源，所以先在 Maven 安装目录下新建本地仓库文件夹 maven_repository 。

settings.xml 文件修改如下：

<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd">
  <!-- <localRepository>标签放Maven仓库路径 -->
  <localRepository>D:/Apache Maven/apache-maven-3.9.8/maven_repository</localRepository>

  <pluginGroups>
  </pluginGroups>

  <proxies>
  </proxies>

  <servers>
  </servers>

<!-- <mirrors>标签中放Maven的下载源 -->
  <mirrors>
    <mirror>
      <id>aliyunmaven</id>
      <mirrorOf>*</mirrorOf>
      <name>Aliyun Public Repository</name>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
  </mirrors>

<!-- <profiles>标签中放jdk的版本 -->
  <profiles>
    <profile>
      <id>jdk-22</id>
      <activation>
        <activeByDefault>true</activeByDefault>
        <jdk>22</jdk>
      </activation>

      <properties>
        <maven.compiler.source>22</maven.compiler.source>
        <maven.compiler.target>22</maven.compiler.target>
        <maven.compiler.compilerVersion>22</maven.compiler.compilerVersion>
      </properties>
    </profile>
  </profiles>

</settings>

除阿里云外其他国内仓库地址：

<!-- NetEase -->
<mirror>
    <id>nexus-163</id>
    <mirrorOf>*</mirrorOf>
    <name>Nexus 163</name>
    <url>http://mirrors.163.com/maven/repository/maven-public/</url>
</mirror>

<!-- Tecent Cloud -->
<mirror>
    <id>nexus-tencentyun</id>
    <mirrorOf>*</mirrorOf>
    <name>Nexus tencentyun</name>
    <url>http://mirrors.cloud.tencent.com/nexus/repository/maven-public/</url>
</mirror>

toolchains.xml 文件修改如下：

<?xml version="1.0" encoding="UTF-8"?>

<toolchains xmlns="http://maven.apache.org/TOOLCHAINS/1.1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/TOOLCHAINS/1.1.0 http://maven.apache.org/xsd/toolchains-1.1.0.xsd">

<!-- <toolchain>的<provides>标签中放jdk版本，<configuration>标签中放jdk安装路径 -->
  <toolchain>
    <type>jdk</type>
    <provides>
      <version>22</version>
      <vendor>oracle</vendor>
    </provides>

    <configuration>
      <jdkHome>C:/Program Files/Java/jdk-22</jdkHome>
    </configuration>
  </toolchain>

</toolchains>

修改好后，在终端输入 mvn help:system 测试，Maven 会自动下载缺省的或者更新的各种配置文件和依赖到本地仓库中。如果出现 Build Success，说明 Maven 已经配置成功了。

四、InetlliJ IDEA 配置

在 Maven 设置里，修改 Maven 主路径、用户设置文件和本地仓库的内容即可。