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 项目开发。

主要配置流程:

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

参考资料:

相关推荐
jianqiang.xue27 分钟前
把Agent塞进MCU:工具次数和上下文长度怎么卡
java·前端·网络·单片机·esp32·ai编程
ikgy2 小时前
JAVA EE:4.多线程核心组件实战
java·java-ee
杨凯凡2 小时前
IT日报|2026-11-19:Oracle Java 紧急补丁、Optimizely 供应链攻击、GitHub 安全评估升级
java·oracle·github
JasonChen@6662 小时前
2.Tomcat 安装部署与一键自动化脚本实战
java·tomcat
SimonKing3 小时前
零 OCR 依赖!Firecrawl 这个 Rust 库把 Word / PPT / Excel 全变成 Markdown
java·后端·程序员
Rain的Java大神之路3 小时前
别被 ChatGPT 的打字机效果骗了:一字一字蹦,才是 LLM 自回归的命门(附大厂 Java 流式落地)
java·后端·面试
渣渣盟3 小时前
狂命爆肝99天,共52K字的JAVA学习笔记奉上,JAVA从入门到精通一文搞定,一文在手JAVA无忧
java·笔记·学习
星落梦生4 小时前
Maven高级(9)
java·maven
兴趣互联15 小时前
jeecgboot nacos2.3.2 使用pgsql
java
hudd66815 小时前
JavaEE 初阶 - 文件操作和IO
java·开发语言·java-ee