JDK 21与IntelliJ IDEA联动配置的关键是环境变量打底、IDE全局识别、项目级绑定三步到位:先验证java -version输出21.x.x LTS,再通过File→New Project设全局SDK为JDK 21,最后在Project Structure中绑定项目SDK并设Language level为21(Preview),用虚拟线程代码验证特性生效。

JDK 21 和 IntelliJ IDEA 联动配置的关键,不是装完就完事,而是让 IDE 真正“认得清”、用得稳 JDK 21 的路径和特性。重点在于环境变量打底、IDE 全局识别、项目级绑定三步到位,缺一不可。
先确认 JDK 21 已正确安装并可被系统识别
这是整个联动的基础。无论用哪种方式安装(Oracle、Temurin、Corretto 或 SDKMAN!),都必须验证终端能直接调出 JDK 21:
- 打开命令行或终端,执行 java -version 和 javac -version
- 输出中必须明确显示 21.x.x 和 LTS 字样,例如:openjdk version "21.0.3" 2024-04-16 LTS
- Windows 用户务必设置 JAVA_HOME 系统变量,值为 JDK 根目录(如
C:\Program Files\Java\jdk-21) - macOS/Linux 用户若用 Homebrew 安装,
brew install openjdk@21后通常自动链接;若未生效,需在 shell 配置文件中添加export JAVA_HOME=$(/usr/libexec/java_home -v21)
在 IDEA 中配置全局默认 JDK(影响新建项目)
避免每次建项目都手动选,统一设好全局 SDK,效率翻倍:
- 启动 IDEA,不打开任何项目 → 点击菜单 File → New Project
- 左侧选 Java,右侧 JDK 下拉框若显示 17 或空白,点击右侧 Download JDK…
- 在弹窗中选择 JetBrains Runtime 21(推荐,与 IDEA 深度优化)或 OpenJDK 21(需已本地安装)
- 下载完成后自动设为默认,后续新建 Java 项目将直接使用 JDK 21 编译和运行
为已有项目手动绑定 JDK 21(含模块级校准)
老项目或导入项目常沿用旧 JDK,必须主动更新,否则编译报错、新特性不生效:
- 打开项目后,按 Ctrl+Alt+Shift+S(Windows/Linux)或 Cmd+; (macOS)进入 Project Structure
- 左侧选 Project → 右侧 Project SDK 下拉框选已安装的 JDK 21(路径如
/usr/lib/jvm/jdk-21或C:\jdk-21) - 再点左侧 Modules → 选中主模块 → 右侧 Language level 设为 21 (Preview) – Virtual threads, Pattern Matching, etc.
- 关键一步:检查 Project compiler output 路径是否可写,避免因权限问题导致编译失败
验证联动是否真正生效
光看设置不等于跑得通,用一个最小实例快速验真:
- 新建一个
Test.java文件,写入虚拟线程示例代码:
Thread.ofVirtual().start(() -> System.out.println("Running on virtual thread"));
- 如果 IDEA 不报红、能跳转到
ofVirtual()源码、且运行输出正常,说明 JDK 21 特性已激活 - 再检查 Help → About 窗口底部,应显示类似 Runtime version: 21.0.3+35-LTS,确认 IDEA 底层也运行在 JDK 21 上


















