IntelliJ IDEA 中高效地使用 Maven（图文并茂）

❤️ 个人主页：水滴技术
🌸 订阅专栏：IntelliJ IDEA 教程
🚀 支持水滴：点赞👍 + 收藏⭐ + 留言💬

大家好，我是水滴~~

IntelliJ IDEA 集成了 Maven 的全部功能，可以让我们轻松的创建和管理 Maven 项目。本文主要讲述在 IntelliJ IDEA 中，如何高效地使用 Maven，这需要你有一定的 Maven 基础。

文章目录

一、Maven 的下载、安装和配置

为了方便以后装机时需要，这里把 Maven 的下载、安装和配置记录一下，已经装过的童鞋可以直接看下一章。

1. 下载

打开 Maven 官网：https://maven.apache.org/，点击左侧的【Download】菜单，进入下载页面。

页面往下滚动至【Files】，该列表为 Maven的最新版的下载链接，点击【Binary zip archive】行的 apache-maven-3.8.5-bin.zip 链接进行下载。

如果想下载历史版本，可以点击【Previous Releases】中的 archives 链接。

如果下载速度慢，可以使用迅雷

2. 安装

将下载好的压缩包，解压到指定目录即可。Maven 的目录结构如下图：

3. 配置

在 Maven 的根目的，进入【conf】文件夹，打开【settings.xml】配置文件，进入下面配置。

3.1 配置本地仓库目录

在

<localRepository>

标签内添加 Maven 的本地仓库目录，这个目录需要你提前创建好。

<!-- localRepository
 | The path to the local repository maven will use to store artifacts.
 |
 | Default: ${user.home}/.m2/repository
<localRepository>/path/to/local/repo</localRepository>
--><localRepository>D:\apache-maven-3.8.5-repository</localRepository>

3.2 添加国内镜像源

在

<mirrors>

标签下添加

<mirror>

，配置一个国内镜像源，用于加速

jar

包的下载。下面示例代码为阿里云的镜像源。

<!-- mirror
   | Specifies a repository mirror site to use instead of a given repository. The repository that
   | this mirror serves has an ID that matches the mirrorOf element of this mirror. IDs are used
   | for inheritance and direct lookup purposes, and must be unique across the set of mirrors.
   |
  <mirror>
    <id>mirrorId</id>
    <mirrorOf>repositoryId</mirrorOf>
    <name>Human Readable Name for this Mirror.</name>
    <url>http://my.repository.com/repo/path</url>
  </mirror>
   --><mirror><id>nexus-aliyun</id><mirrorOf>central</mirrorOf><name>Nexus aliyun</name><url>http://maven.aliyun.com/nexus/content/groups/public</url></mirror>

3.3 设置 Maven 的 JDK 版本

在

<profiles>

标签下添加

<profile>

，配置 JDK 版本。

<!-- profile
 | Specifies a set of introductions to the build process, to be activated using one or more of the
 | mechanisms described above. For inheritance purposes, and to activate profiles via <activatedProfiles/>
 | or the command line, profiles have to have an ID that is unique.
 |
 | An encouraged best practice for profile identification is to use a consistent naming convention
 | for profiles, such as 'env-dev', 'env-test', 'env-production', 'user-jdcasey', 'user-brett', etc.
 | This will make it more intuitive to understand what the set of introduced profiles is attempting
 | to accomplish, particularly when you only have a list of profile id's for debug.
 |
 | This profile example uses the JDK version to trigger activation, and provides a JDK-specific repo.
<profile>
  <id>jdk-1.4</id>

  <activation>
    <jdk>1.4</jdk>
  </activation>

  <repositories>
    <repository>
      <id>jdk14</id>
      <name>Repository for JDK 1.4 builds</name>
      <url>http://www.myhost.com/maven/jdk14</url>
      <layout>default</layout>
      <snapshotPolicy>always</snapshotPolicy>
    </repository>
  </repositories>
</profile>
--><profile><id>JDK-1.8</id><activation><activeByDefault>true</activeByDefault><jdk>1.8</jdk></activation><properties><maven.compiler.source>1.8</maven.compiler.source><maven.compiler.target>1.8</maven.compiler.target><maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion></properties></profile>

3.4 配置环境变量

添加

M2_HOME

环境变量，变量值为 Maven 根目录。

编辑

Path

环境变量，添加

%M2_HOME%\bin

在

cmd

命令中输入

mvn -v

命令进行验证，打印下面的版本信息，表示环境变量配置成功。

二、IDEA 配置 Maven 环境

刚安装好的 IntelliJ IDEA 需要我们配置一下 Maven 环境，使我们 Maven 项目使用同一环境。下面开始配置：

打开【Settings】对话框，依次点击【Build, Execution, Deployment】—【Build Tools】—【Maven】，或者直接搜索“maven”。

在右侧选择我们安装的 Maven 环境：

① 选择 Maven 安装目录

② 勾选【Overrid】后，选择 settings.xml 文件

③ 选择本地仓库目录（操作完 ① 后，会自动选择目录）

三、IDEA 创建 Maven 项目

在 IntelliJ IDEA 中可以轻松的创建 Maven 项目，并为其创建模块（Module）。

1. 创建 Maven 项目

依次点击菜单【File】—【New】—【Project…】，会打开【New Project】对话框，选中左侧的【Maven】，表示创建一个 Maven 项目。【Project SDK】默认选择系统安装的 Java 版本，然后点击【Next】进入下一步。

注：如果想要根据模板创建 Maven 项目，请勾选【Create from archetype】，然后选择一个模板。关于模板的介绍，可以参考 Maven 官网：Introduction to Archetypes

下面填写项目信息，其中：

① 项目名称

② 项目的本地目录

③ ④ ⑤ 为 Maven 项目的“GAV坐标”

最后点击【Finish】创建了一个 Maven 项目

下图为该 Maven 项目的目录结构，其中

pom.xml

文件已创建好。

2. 创建模块（Module）

右击 Maven 项目，依次选择【New】—【Module…】，表示创建一个模块

之后会打开【New Module】对话框，与创建 Maven 项目是一样，点击【Next】进入下一步

下面填写模块信息，其中：

① 上级项目名称，默认为刚才选中的项目

② 模块名称

③ 模块的本地目录

④ ⑤ ⑥ 为 Maven 模块的“GAV坐标”

最后点击【Finish】创建了一个 Maven 模块

下图为该 Maven 模块的目录结构，同样

pom.xml

文件已创建好。

并且，在上级项目的

pom.xml

文件，自动增加了

modules

模块。

当然，一个项目可以有多个模块，创建方式相同。下图中创建了多个模块：

四、IDEA 执行 Maven 命令

1. 通过“终端”执行命令

在 IntelliJ IDEA 中可以执行 Maven 命令，点击下面的【Terminal】，就可以执行 Maven 命令了（这与在

cmd

命令行中执行没有区别）。

1.1 打包命令

执行打包命令：

mvn clean package

，会在每个模块中输出一个

target

目录，里面存放打好的

jar

包。

1.2 安装命令

执行安装命令：

mvn clean install

，同样会输出

target

目录，并且会将项目和模块安装至本地 Maven 仓库中。

2. 通过“Maven 工具窗口”执行命令

如果你不想手动输出命令，还可以通过 Maven 工具窗口来执行命令。

2.1 打开 Maven 工具窗口

点击右侧的【Maven】即可打开 Maven 工具窗口；

或者通过菜单【View】—【Tool Windows】—【Maven】来打开。

2.2 执行命令

可以在 Maven 工具窗口中，为项目或单个模块执行 Maven 命令，只需双击【Lifecycle】中的命令即可

也可以同时执行多个命令，只需按住【Ctrl】键，选中要执行的命令，并右击命令，执行【Run Maven Build】即可

3. 通过“Maven 运行/调试配置”执行命令

我们可以将常用的命令组添加到“运行配置”中，便于我们后面的使用。下面介绍如何添加配置和执行命令。

在工具栏中点击【Add Configuration…】按钮

点击【+】号按钮，然后选择【Maven】，会创建一个 Maven 配置

在【Run】中选择输入或选择相应命令，其他配置按默认即可，最后点击【OK】。

此时工具栏中会显示刚才添加的配置

点击右侧的运行按钮，即可执行相应命令。

此处可以添加多个配置，用于执行不同的命令组。

五、IDEA 管理 Maven 依赖

1. 添加并加载依赖

在

pom.xml

中添加依赖后，右上角会出现一个“刷新”按钮

刷新后，会将

jar

包下载到 Maven 本地仓库，并引入该项目中。

2. 重新加载依赖

如果有些依赖没有下载，可以重新加载依赖

打开右侧“Maven工具窗口”，点击“刷新”按钮，会重新加载所有项目 Maven 依赖。

也可以右击某个项目或模块，选择【Reload project】来加载该项目的依赖。

3. 下载源码

如果查看依赖中的类，没有源码的话，可以点击右上角的【Download Sources】来下载源码。

4. 配置自动下载源码

打开【Settings】对话框，依次选择【Build, Execution, Deployment】—【Build Tools】—【Maven】—【Importing】，在右侧的自动下载【Automatically download】中，勾选【Source】、【Documentation】、【Annotations】，最后点击【OK】。

这样后面再下载依赖时，会将源码一同下载到本地。