IntelliJ IDEA 配置 JDK 21 与 Maven 教程（Windows）：开发环境配置与验证

一、准备工作

配置前，请确保已经安装以下软件：

IntelliJ IDEA
JDK 21
Apache Maven

官方下载地址：

本文主要介绍 IDEA 中的环境配置，不再重复 JDK 和 Maven 的安装过程。

JDK 21 详细安装教程

Apache Maven 详细安装教程

二、配置 JDK 21

1. 打开项目结构设置

打开 IntelliJ IDEA，依次选择：

File → Project Structure

也可以使用快捷键：

text 复制代码

Ctrl + Alt + Shift + S

2. 配置 Project SDK

在 Project 页面中，找到 SDK 或 Project SDK。

在列表中直接选择 JDK 21 即可。

配置完成后，确认：

Project SDK：JDK 21
Language level：21，或者使用 SDK 默认语言级别

最后点击 Apply → OK 保存。

3. 如果是多模块项目 (单模块可以跳过)

Project Structure → Modules

把每个模块下面的 Sources → Language level 都选成对于的 21-Record patterns, pattern matching for switch 语言级别

Project Structure → Modules

把每个模块下面的 Dependencies→ Module SDK 都选成对于的 Project JDK 21

最后点击 Apply → OK 保存。

4. 验证 JDK

打开 IDEA 底部的 Terminal 终端，执行：

powershell 复制代码

java -version

powershell 复制代码

javac -version

如果正常显示 Java 21 版本，说明终端中的 JDK 环境配置正常。

注意：终端使用的 Java 版本可能与 Project SDK 不同。Project SDK 需要在项目结构页面单独确认。

5. 也可以全局配置

还是在刚刚打开的地方

选择对应的版本即可

最后点击 Apply → OK 保存。

三、配置 Maven

1. 打开 Maven 设置

使用快捷键：

text 复制代码

Ctrl + Alt + S

依次进入：

Build, Execution, Deployment → Build Tools → Maven

2. 配置 Maven 路径

找到 Maven home path。

如果使用自己安装的 Maven，可以选择对应的安装目录，例如：

text 复制代码

D:\devtool\Java\apache-maven-3.9.9

注意：选择 Maven 根目录，不是 bin 目录。

如果项目已经提供 Maven Wrapper，也可以选择 Use Maven wrapper，优先使用项目指定的 Maven 版本。

3. 配置 Maven settings.xml

在 Maven 设置页面中，找到：

User settings file

选择自己配置的 settings.xml 文件，例如：

text 复制代码

D:\devtool\Java\apache-maven-3.9.9\conf\settings.xml

如果使用 Maven 默认配置，也可以保留 IDEA 自动识别的用户配置文件。

4. 配置本地仓库

找到 Local repository。

例如：

text 复制代码

D:\devtool\Java\apache-maven-3.9.9\repository

如果已经在 settings.xml 中配置了本地仓库：

xml 复制代码

 <localRepository>D:/devtool/Java/apache-maven-3.9.9/repository</localRepository>

建议保持 IDEA 与 Maven 配置中的仓库路径一致。

如果没有特殊需求，也可以使用 Maven 默认的本地仓库目录。

配置完成后，点击 Apply → OK 保存。

四、配置 Maven 使用 JDK 21

为了避免 Maven 构建时使用其他 Java 版本，需要检查 Maven 的 JDK 设置。

1. 配置 Maven Runner

进入：

File → Settings → Build, Execution, Deployment → Build Tools → Maven → Runner

找到 JRE，选择：

text 复制代码

Project JDK (21)

也可以直接选择本地安装的 JDK 21。

2. 配置 Maven Importing

进入：

File → Settings → Build, Execution, Deployment → Build Tools → Maven → Importing

找到 JDK for importer。

选择：

text 复制代码

Project JDK

或者直接指定 JDK 21。

这样 Maven 项目导入和依赖解析可以使用指定的 JDK。

五、验证 Maven 配置

1. 查看 Maven 版本

打开 IDEA 的 Terminal，执行：

powershell 复制代码

mvn -v

正常情况下会显示类似信息：

text 复制代码

Apache Maven 3.x.x
Java version: 21
OS name: "windows"

注意：这里的 mvn -v 检查的是终端 PATH 中的 Maven，不一定等于 IDEA Maven 设置页面中选择的版本。

2. 创建 Maven 测试项目

在 IDEA 中选择：

File → New → Project

然后配置：

Name：maven-demo
Language：Java
Build system：Maven
JDK：21

点击 Create 创建项目。

3. 配置 Java 编译版本

打开项目中的 pom.xml，添加：

xml 复制代码

<properties>
    <maven.compiler.release>21</maven.compiler.release>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

配置完成后，点击 Maven 工具窗口中的 Reload 按钮，重新加载项目。

4. 测试项目构建

在项目根目录的 Terminal 中执行：

powershell 复制代码

mvn clean package

如果项目正确配置了 Maven 编译插件及其版本，并且依赖下载正常，构建成功后会出现：

text 复制代码

BUILD SUCCESS

也可以在 IDEA 右侧的 Maven 工具窗口中执行：

Lifecycle → package

如果终端构建成功，但 IDEA Maven 工具窗口构建失败，应分别检查它们使用的 Maven 和 JDK 版本。

六、常见问题

1. IDEA 无法识别 JDK 21

进入：

File → Project Structure → Project

检查 Project SDK 是否指向正确的 JDK 21 安装目录。

如果仍然有问题，可以尝试重新添加 JDK。

2. Maven 使用的 Java 版本不是 21

检查以下配置：

Project SDK
Maven Runner 中的 JRE
Maven Importing 中的 JDK
系统环境变量 JAVA_HOME

可以执行：

powershell 复制代码

mvn -v

查看终端中 Maven 实际使用的 Java 版本。

3. Maven 依赖下载失败

检查以下内容：

网络是否正常。
settings.xml 是否配置正确。
Maven 仓库镜像地址是否可用。
IDEA 是否开启了 Maven Offline（离线模式）。

修改配置后，可以重新加载 Maven 项目。

4. IDEA 配置成功，但终端无法使用 mvn

如果执行：

powershell 复制代码

mvn -v

提示找不到命令，检查系统 Path 环境变量是否包含 Maven 的 bin 目录。

例如：

text 复制代码

D:\devtool\Java\apache-maven-3.9.9\bin

保存环境变量后，重新打开 IDEA 或终端再验证。

七、总结

完成以上配置后，IntelliJ IDEA 就可以使用 JDK 21 和 Maven 进行 Java 项目开发。

主要配置流程：

配置 Project SDK 为 JDK 21。
配置 Maven 安装目录。
指定 Maven settings.xml。
配置 Maven 本地仓库。
设置 Maven Runner 和 Importing 的 JDK。
创建 Maven 项目并执行构建验证。

参考资料：