idea | 搭建 SpringBoot 项目之配置 Maven

目录

• • [1 配置 Maven](#1 配置 Maven)
  • • [1.1 打开 settings.xml 文件](#1.1 打开 settings.xml 文件)
    • 1.2 配置本地仓库路径
    • 1.3 配置中央仓库路径
    • [1.4 配置 JDK 版本](#1.4 配置 JDK 版本)
    • 1.5 重新下载项目依赖
  • [2 配置 idea](#2 配置 idea)
  • • 2.1 在启动页打开设置
    • [2.2 配置 Java Compiler](#2.2 配置 Java Compiler)
    • [2.3 配置 File Encodings](#2.3 配置 File Encodings)
    • [2.4 配置 Maven](#2.4 配置 Maven)
    • [2.5 配置 Auto Import](#2.5 配置 Auto Import)
    • [2.6 配置 Code Completion](#2.6 配置 Code Completion)
    • [2.7 安装 Lombok 和 MyBatisX 插件](#2.7 安装 Lombok 和 MyBatisX 插件)

---

Maven 下载依赖时报错：

Failure to find org.springframework.boot:spring-boot-starter-parent:pom:3.3.5.RELEASE in

可能的原因：

1. 上不了外网且没有给 Maven 配置国内镜像
2. 图中所示的中央仓库确实没有这个包

我更倾向于是第一种原因，因此决定给 Maven 配置国内镜像。

参考的视频：

• 005-尚硅谷-尚融宝-开发环境检查 （https://www.bilibili.com/video/BV1VV411n7nR）

该视频介绍了如何配置 Maven，或许比本博客更加清晰，请按需自取。

1 配置 Maven

1.1 打开 settings.xml 文件

settings.xml 文件在 Maven 的安装路径下：

E:\maven\apache-maven-3.6.3\conf\settings.xml

使用任一编辑器（记事本或 VSCode 等）打开 settings.xml 文件即可。

说明：由于你和我的 Maven 安装路径不同，因此这里的路径请视具体情况而定。

1.2 配置本地仓库路径

Ctrl + F 查询以下标签：

<localRepository>

配置本地仓库路径：

<localRepository>E:\maven\repository</localRepository>

说明：本地仓库用于存放 Maven 下载的所有的包，我们需要创建一个文件夹作为本地仓库来存放这些包。这里的 "repository" 是我自己创建的文件夹，你完全可以取其他名字，此外也可以存放在其他路径下。

配置结果如下图所示：

1.3 配置中央仓库路径

Ctrl + F 查询以下标签：

<mirror>

配置中央仓库路径，这里使用的是阿里云的仓库：

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

说明：上述配置代码源自阿里云的官方指南（https://developer.aliyun.com/mvn/guide）

配置结果如下图所示：

注意：你可能发现我图中写的是 "central"，而原配置写的是 "public"，因为此处有雷 😇

1.4 配置 JDK 版本

Ctrl + F 查询以下标签：

<profile>

配置 JDK 版本，这里使用的版本是 1.8：

<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>

配置结果如下图所示：

1.5 重新下载项目依赖

使用 idea 打开自己的 SpringBoot 项目，在项目的 Terminal 中运行：

mvn install

如果所有依赖都安装成功，那么就代表配置成功！

如果仍然报错：

Failure to find org.springframework.boot:spring-boot-starter-parent:pom:3.3.5.RELEASE in

那么需要在阿里云仓库中检查该包是否存在，以及在哪个仓库中：

两种解决方法：

1. 在项目的 pom.xml 中修改版本号为当前仓库所含版本号
2. 在 Maven 的 settings.xml 中修改中央仓库为含当前版本号的仓库

举例说明：

我想使用的版本号是 2.7.6，但通过查询阿里云发现该版本只在 "central" 仓库中有：

因此设置中央仓库的路径为：

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

然后再重新安装依赖即可。

2 配置 idea

2.1 在启动页打开设置

点击右下角的 "Configure"，然后点击第一个选项 "Settings"：

说明：之所以在启动页打开设置，是因为只有这么做，设置内容才是对所有项目都生效的。

2.2 配置 Java Compiler

2.3 配置 File Encodings

三个地方均需设置为 "UTF-8"：

2.4 配置 Maven

分别配置 Maven 的根路径、配置文件路径、本地仓库路径：

注意：在修改配置文件路径、本地仓库路径前，先勾选 "Override" 选项。

2.5 配置 Auto Import

勾选下图中的两个选项，实现自动导包和自动删除包：

2.6 配置 Code Completion

取消勾选 "Match case"，使得代码补全时不区分大小写：

2.7 安装 Lombok 和 MyBatisX 插件

搜索并安装这两个插件即可：