IntelliJ IDEA 配置 JDK 21 与 Maven 教程(Windows):开发环境配置与验证

作者:少年的范儿日期:2026/11/7

一、准备工作

配置前,请确保已经安装以下软件:

  • IntelliJ IDEA
  • JDK 21
  • Apache Maven

官方下载地址:

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

JDK 21 详细安装教程
Apache Maven 详细安装教程

二、配置 JDK 21

1. 打开项目结构设置

打开 IntelliJ IDEA,依次选择:

File → Project Structure

也可以使用快捷键:

1Ctrl + Alt + Shift + S
2

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 终端,执行:

1java -version
2
1javac -version
2

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

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

5. 也可以全局配置

还是在刚刚打开的地方

选择对应的版本即可
最后点击 Apply → OK 保存。

三、配置 Maven

1. 打开 Maven 设置

使用快捷键:

1Ctrl + Alt + S
2

依次进入:

Build, Execution, Deployment → Build Tools → Maven

2. 配置 Maven 路径

找到 Maven home path。

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

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

注意:选择 Maven 根目录,不是 bin 目录。

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

3. 配置 Maven settings.xml

在 Maven 设置页面中,找到:

User settings file

选择自己配置的 settings.xml 文件,例如:

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

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

4. 配置本地仓库

找到 Local repository。

例如:

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

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

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

建议保持 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,选择:

1Project JDK (21)
2

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

2. 配置 Maven Importing

进入:

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

找到 JDK for importer。

选择:

1Project JDK
2

或者直接指定 JDK 21。

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

五、验证 Maven 配置

1. 查看 Maven 版本

打开 IDEA 的 Terminal,执行:

1mvn -v
2

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

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

注意:这里的 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,添加:

1<properties>
2    <maven.compiler.release>21</maven.compiler.release>
3    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
4</properties>
5

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

4. 测试项目构建

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

1mvn clean package
2

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

1BUILD SUCCESS
2

也可以在 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

可以执行:

1mvn -v
2

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

3. Maven 依赖下载失败

检查以下内容:

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

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

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

如果执行:

1mvn -v
2

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

例如:

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

保存环境变量后,重新打开 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 项目并执行构建验证。

参考资料:


《IntelliJ IDEA 配置 JDK 21 与 Maven 教程(Windows):开发环境配置与验证》 是转载文章,点击查看原文。


相关推荐


Linux 网络:HTTP(三)Linux 服务器实现
AbandonForce2026/10/30

Linux 网络:HTTP(三)Linux 服务器实现 引言 前两篇已经介绍了 HTTP 报文、方法、状态码和登录状态。现在把这些规则落实到 Linux 程序中:浏览器访问首页时,服务器怎样把收到的字节变成请求对象,再找到文件、组织响应,最后完整地发回去? 实现一个教学服务器,重点不在于把所有 HTTP 功能一次写齐,而在于让收发、解析和业务各自承担明确的职责。下面结合 C++17 代码片段分析这些模块,以及从回显程序扩展到 HTTP 时需要补上的处理。 一、服务器的模块与调用顺序 最


PHP 紧急修复两项严重 RCE 漏洞,8.2 至 8.5 用户应立即升级
BingoGo2026/10/22

PHP 紧急修复两项严重 RCE 漏洞,8.2 至 8.5 用户应立即升级 2026 年 10 月 21 日,PHP 官方发布紧急安全公告,并同时推出 PHP 8.5.12、8.4.27、8.3.36 和 8.2.35,修复两项可能导致**未经身份验证的远程代码执行(RCE)**的漏洞。 这两项漏洞的 CVSS v4.0 评分均为 9.2,严重级别为 Critical。已验证的代码执行以 Web 工作进程的权限运行,并不意味着直接获得 root 权限;但应用凭据、业务数据和服务可用性仍可能受到严


AI for Testing 提效实战 · 执行自动化(四):脚本坏了让 AI 自愈——它说修好了,你凭什么信
匠测AI说2026/10/17

上一篇把 AI 分诊接进 CI 时,我们留了一道默认关着的门:L3,让 AI 自己改代码。这一篇推开一条缝,聊它最成熟、风险最低的一个落地场景——前端改版把脚本弄失效了,让 AI 自动修脚本(self-healing,测试自愈)。 2026 年主流框架和商业平台大多已经内置自愈:Playwright 有官方 healer,Cypress 有 cy.prompt,Selenium 系有 Healenium,商业平台 Testim/Mabl 更是标配。如果你是 Python 栈、官方方案覆盖不到,第


从流程引擎到工程管理:CCFlow CCPrj 模块设计与实现驰骋BPM驰骋低代码低代码工作流引擎
驰骋低代码、工作流、表单引擎2026/10/12

从流程引擎到工程管理:CCFlow CCPrj 模块设计与实现 本系列共 3 篇: ① 设计与实现(本文) ② 产品介绍 ③ 源码导读 流程解决“审批怎么走”,工程解决“任务怎么干”。本文从需求出发,梳理 CCFlow 工程管理模块(CCPrj)的分层架构、数据模型、状态机与关键实现。 一、先说结论 CCPrj 不是把甘特图硬塞进流程引擎,而是参照流程引擎的分层方式,单独做了一套工程运行时: 设计态:工程类别 → 工程模板 → 任务组 / 任务运行态:工程实例 → 任务组实例 /


LangSmith:从链路追踪到 RAG 自动化评估
东风破_2026/10/4

做过 LangGraph Agent 或 RAG 之后,很快就会遇到一个问题: 程序虽然能跑,但内部到底发生了什么? 一次请求经过了哪些节点?Retriever 返回了什么?模型真正收到的 Prompt 是什么?哪一步最慢?Token 消耗多少?某次异常究竟出在哪个 Run? 再往后还会遇到另一个问题: 这个 Agent 或 RAG 到底“好不好”? 靠人工随便问几个问题,只能得到主观感受。真正进入工程阶段之后,我们需要的是可观测、可回归、可量化。 LangSmith 主要解决的就是这两类问题。


HTTP 407 排错实战:CONNECT、认证注入与容器凭据安全
IPdodo_2026/9/27

HTTP 407 往往被笼统归为“网络错误”,但它实际上给出了非常具体的协商结果:客户端已经到达中间网关,而网关要求代理认证,当前请求没有提供可接受的凭据。继续替换出口或无上限重试,通常不会改变认证协商失败这一事实。 本文以企业内网网关、容器化服务和经过授权的接口调用为例,说明 CONNECT 隧道的认证位置、requests 的配置优先级、容器凭据注入和可审计的排查流程。所有地址和账号均为占位符。 一、407 与 401、403、429 分别发生在哪一层 访问 HTTPS 目标时,客


【Linux】线程同步与互斥
道尔柯南2026/9/19

🎬 个人主页:道尔柯南 ❄专栏传送门:《C语言》《C++》《Linux操作系统》 昙花一现,却等待了整个白昼;蝉鸣一夏,却蛰伏了好几个四季。 文章目录 从互斥到线程池:C++ 多线程同步与互斥实战笔记1. 为什么需要线程同步与互斥?2. 互斥量:给临界区上锁3. 条件变量:等待与通知4. 生产者消费者模型5. 信号量与环形队列6. 线程池:任务与执行解耦7. 日志、策略模式与单例8. 线程安全与可重入9. 死锁与常见锁10. STL 与智能指针的线程安全11.


PyTorch训练坏样本自动定位:避免任务跑几小时后突然中断
ai小陈2026/9/11

深度学习任务运行数小时后,突然因损坏图片、空标注或异常尺寸报错,是GPU算力平台上的高频问题。此时GPU本身通常没有故障,真正原因是数据集没有在训练前完成校验。本文以PyTorch为例,搭建“预扫描—运行捕获—隔离清单—复核修复”的坏样本定位流程。 一、问题背景 常见异常包括图片无法解码、标签越界、文本编码错误、输入包含NaN,以及不同样本Shape无法组成Batch。小规模调试可能碰不到这些文件,大模型训练或长周期深度学习实验一旦随机读取到坏样本,整个进程就可能退出。 GPU服务器租用往


【AI】大模型本地部署与量化:Ollama、transformers、llama.cpp实践
漂流瓶jz2026/9/3

部署即在本地电脑中下载并运行模型,就像使用网络上的大模型API一样,但区别在于模型是运行在本地的,不收费也不会泄露信息。但模型可能很大,本地电脑可能会内存不足,这时候就需要量化来尝试缩小模型存储空间,同时尽量避免模型性能损失。 Ollama Ollama是一个大模型部署工具,用它只需要执行几个命令,就可以在本地电脑下载和部署大模型。官网列出了非常多可以部署的模型,有官方模型,也有用户训练/调整过的模型。 使用Ollama部署 首先安装Ollama本身,然后执行命令行。这里我们以Qwen3:0.6


本体论的基本核心概念
Shawn_Shawn2026/8/26

核心概念 Ontology(本体) 本体不是某一张表,而是整个组织共享的语义模型:它定义了企业里有哪些实体类型、实体有哪些属性、实体之间如何关联、可以对实体执行哪些操作。 在许多应用场景中,本体充当了组织的“数字孪生”(Digital Twin),兼具支持各类用例所需的语义元素(对象、属性、链接)和动力学元素(操作、函数、动态安全管控)。 对象类型(Object type) 定义了组织中的一个实体或事件。 属性(Property) 定义了对象类型的特征。 链接类型(Link type) 定义了

首页编辑器站点地图

本站内容在 CC BY-SA 4.0 协议下发布

Copyright © 2026 聚合阅读