在IDEA中配置JDK，核心路径是打开File → Project Structure → SDKs点击加号选择JDK，然后给项目或模块指定这个SDK，同时把Language Level设为对应版本，这样IntelliJ IDEA就能正常编译、运行和调试你的Java代码。
很多Java开发者在刚接触IntelliJ IDEA时会遇到编译报错、代码不提示、运行按钮灰色这类问题，原因多半是IDEA根本没找到正确的JDK，或者项目级别的SDK设置与全局配置互相冲突，这篇文章不绕弯子，按照实际操作的顺序把idea的jdk配置这件事讲透，我用的是Windows系统举例，macOS的按钮位置基本一样，只是弹窗样式略有区别。
配置前先分清SDK、JDK、JRE和Language Level
在动手操作IDEA之前,有三组概念需要先理清，如果这几个概念混淆，后面很多选项看起来就像天书。
- JDK（Java Development Kit）：开发工具包，包含了javac编译器、jdb调试器、JRE运行环境，还有一堆命令行工具，写代码必须用JDK，不是只装JRE就行。
- JRE（Java Runtime Environment）：只包含运行时环境和JVM，能让已编译的class文件跑起来，但不能编译代码，如果一个操作系统里只装了JRE，IDEA即便指向了它也没法编译。
- SDK（Software Development Kit）：在IDEA的概念里，SDK是一个更上层的统称，它既可以指向某个安装好的JDK，也可以指向JDK版本对应的开发环境，IDEA里添加JDK时，实际上是在添加一个SDK类型为JDK的条目。
- Language Level（语言级别）：指定编译器按照哪个Java语法版本来解析代码，比如设置为17，代码里就不能使用Java 21的语法特性，编译也会直接报错，Language Level必须跟所选SDK的版本匹配，否则会出现”此语言级别不支持该语法”的提示。
行业共识认为,本地机器上安装的JDK路径中不能包含中文或空格，否则IDEA在识别javac路径时偶尔会出现异常，推荐直接把JDK装在磁盘根目录下，比如C盘直接一个jdk-21文件夹，这样路径简短，避免很多潜藏的麻烦。
首次打开IDEA配置JDK的全过程
idea的jdk配置在哪里
如果你是第一次打开IDEA,或者电脑上还没配置过任何JDK，那么不管新建项目还是导入已有Maven项目，IDEA都会提示”No JDK found”，这时候需要手动告诉IDEA你的JDK安装位置。
操作路径如下：
- 点击右下角的Configure按钮，或者直接进File → Project Structure（快捷键Ctrl+Alt+Shift+S）。
- 在左侧导航栏选择SDKs
，这是管理所有SDK（即JDK）的地方。
- 点击上方工具栏的加号，选择Add JDK…。
- 在弹出的文件选择器中,找到你安装JDK的根目录，选中它并点击OK。
选中目录后,IDEA会自动探测这个JDK的版本号，并在下方列出它的Home Path和javac路径，如果IDEA提示”Invalid SDK path”，说明你选错了文件夹，注意要选到包含bin目录的那一层，而不是bin里面，举个例子，正确路径是D:Javajdk-21，不是D:Javajdk-21bin。
添加完SDK以后,还需要把项目模块挂到这个SDK下面，继续在Project Structure窗口里，切换到Project一栏，把Project SDK设置为刚才添加的JDK，同时把Project Language Level设置为该JDK对应的版本，再切换到Modules一栏，确认模块的Module SDK也选了这个JDK，Language Level同样设为一致，这一步稍不留意就会造成”项目SDK和模块SDK不一致”的局面，IDEA会以模块SDK为准进行编译，所以哪里报错就检查哪里。
新建项目时的JDK选择
新建项目的场景更直观,在IDEA的欢迎界面点击New Project，向导中会有一个专门选择JDK的复选框，如果下拉框里没有想要的版本，点击旁边的Add JDK按钮，依然是找到本地安装路径并选中，IDEA 2026及之后的版本，新建项目向导还会弹出”Boot JDK”和”Gradle JVM”这些额外选项，一般保持默认即可。
值得一提的是,IDEA旗舰版（Ultimate）和社区版（Community）在这个界面没本质区别，只是社区版不支持一些JavaEE框架的自动配置，JDK选择机制完全相同。
多版本JDK环境下，idea怎么切换jdk版本
一台电脑装了好几个JDK版本,比如同时装了JDK 8、JDK 17和JDK 21，这是不少实际开发者的常态，不同老项目要求JDK8，新项目要求JDK17，切换场景很频繁。
切换单个项目的JDK版本
打开当前项目的Project Structure（Ctrl+Alt+Shift+S），在Project页签里调整Project SDK下拉框即可切换，IDEA会自动重新扫描模块依赖并重建索引，这个过程可能要等几十秒，如果切换后发现Maven依赖出现红波浪线，执行一次Reload Maven Project刷新依赖列表即可。
修改全局默认JDK
如果你希望以后新建的所有项目都默认使用某个JDK版本,顺着以下路径设置：
- 打开File → Settings（快捷键Ctrl+Alt+S）。
- 找到Build, Execution, Deployment → Build Tools → Maven
。
- 把Runner下的JRE改为你要的全局JDK版本。
- 再回到Project Structure里，修改Project默认的SDK设置。
不过IDEA没有单独提供”全局默认SDK”选项，它的默认值由最后一次打开的项目决定，所以更稳妥的办法是让所有项目模板都指向同一个JDK路径，这可以通过修改默认项目模板实现，在欢迎界面点击Customize，打开Project Structure里的Default Project Settings，给这个默认项目设置好SDK，这样后续所有新建项目都会继承这个配置。
通过环境变量配合版本管理工具
纯用IDEA界面切换版本是一次性的,如果要频繁切换且不想每次都打开设置框，建议配合使用JAVA_HOME环境变量切换工具，比如jenv（macOS/Linux）或win-jdk-switch这类小脚本，切换前先确认系统环境变量里JAVA_HOME指向的是哪个版本，因为IDEA创建的某些构建任务（比如Gradle、Maven打包）会优先读取JAVA_HOME的值，而不是Project SDK，多级设置同时存在时，IDEA的优先级规律是：Gradle或Maven里的JVM配置 > 模块SDK > 项目SDK > JAVA_HOME环境变量，这条规则弄清楚后，就可以精准定位到底是谁在影响具体构建任务。
常见配置问题与排查对照
IDEA配置JDK后,最常见的报错有这么几类，我把现象、原因和解决方法放在一张表中做对比。
| 报错现象或提示 | 根本原因 | 解决办法 |
|---|---|---|
| Error:java: Source option 8 is no longer supported | Language Level是8，但用了高版本JDK编译 | 在Settings里把Java Compiler的Target bytecode version调到匹配版本 |
| Cannot resolve symbol: var | 语言级别设置过低 | 在Module的Language Level里改为合适的版本 |
| Invalid JDK configuration found | 指向了已经移动或删除的JDK目录 | 删除该项目下的SDK配置，重新添加实际存在的JDK路径 |
| java: 无效的源发行版: 17 | 编译器的目标版本与SDK版本不同步 | 检查Project Structure里的三个位置：Project、Modules、Java Compiler，全部改成一致 |
| Lombok 1.18.20 requires Java 17 or later | 依赖库要求的JDK版本高于当前配置 | 升级JDK版本，或者换用更低版本的Lombok依赖 |
排查这类问题时,最好的办法就是统一把Project SDK、Module SDK、Java Compiler里的bytecode version这三处设为完全相同，就在Settings路径Build, Execution, Deployment → Compiler → Java Compiler
下，把Per-module bytecode version设置为同一个版本，多数情况下，这三处对齐后异常就会消失。
命令行和IDEA的JDK配置联动
有些开发者习惯先在命令行里验证代码,然后才打开IDEA，命令行下用的JDK版本取决于PATH环境变量里的java命令怎么解析，你可以直接在终端执行java -version确认当前生效版本，但要注意，这个值跟IDEA内的项目SDK没有直接关系，除非你在IDEA里给项目添加了同名JDK却指向了不同目录，所以很多老手会在把环境变量切换到某个版本后，先在命令行编一次码，再打开IDEA确认Project SDK与之一致，以此确保两边没有代差。
总结一点实用经验
在IDEA里配置JDK这事不难,但一步不对后面全错，按优先级来操作：先确认机器上装了对应版本的JDK并记住安装路径然后在Project Structure的SDKs里添加它再同步Project、Modules和Java Compiler三处设置最后重启或重载Maven项目，这样可以解决绝大多数编译异常，记住最重要的一句话：凡是报错提到Source option、Target option、无效源发行版、无效的JDK配置，都要回到Project Structure里的这三处设置检查一致性，而不是盲目重装JDK。
关于IDEA的JDK配置常见问题
我安装了JDK，但IDEA的SDK列表里找不到它怎么办？
这是因为IDEA不会扫描全盘JDK安装位置,它只识别已添加过的SDK，手动点击SDKs面板的加号，选择Add JDK，然后在文件选择器里定位到JDK安装目录的根路径，如果依然找不到，检查是否误装了只包含JRE的版本，或者Windows系统里通过Uninstall程序卸载过旧版本，导致注册表残留指向了已不存在的旧路径。
项目SDK选了17，但IDEA运行Maven构建时还是用的Java 8，为什么？
Maven Runner的JVM设置优先级比项目SDK高，打开Settings中的Maven分类，查看Runner下的JRE是否被手动指定成了8，如果没有指定，Maven会尝试使用JAVA_HOME变量所指向的JDK，解决方法是直接把JAVA_HOME改成你要用的JDK17路径，或者在Maven Runner里显式选择JDK17。
导入别人的项目后，右下角提示”Project SDK is not defined”，如何快速修复？
这种项目携带了.idea目录里的旧配置，但对方机器上的JDK路径与你的不同，先按照本文第一步添加你自己的JDK到SDKs列表，然后打开Project Structure，分别检查Project和Modules两项，把尚未定义SDK的位置全部选定为刚才添加的版本，最后在Maven或Gradle工具窗口点击刷新按钮重新拉取依赖，配置即生效。