在IDEA中配置JDK的核心答案：新手装好JDK后，最稳的路径是依次完成“全局SDK设置”“项目SDK设置”和“模块SDK设置”，并确认Gradle或Maven的JVM指向与IDEA运行环境一致，这样就能避开90%的编译报错。IDEA（IntelliJ IDEA）对JDK的管理并不复杂，但它把配置入口分散在了三个层级，理解这套逻辑后，无论是打开老项目还是新建工程，你都能从容应对，这篇文章会带你从头到尾走一遍完整流程，并单独聊聊那些让人头疼的版本切换和编译报错问题。
弄清IDEA管理JDK的三个层级
很多人在idea中配置jdk时犯迷糊,是因为没分清设置面板和项目结构之间的差异，IDEA把JDK配置分成了全局层面和项目层面，各自管各自的事。
全局SDK配置：一次设置，长期生效
全局配置适用于所有新打开的项目,除非某个项目单独指定了其他版本，打开IDEA欢迎页，点击右下角的Configure，然后选择Structure for New Projects；或者进入已打开项目的 File > Project Structure，在左侧栏找到SDKs。
点击顶部加号，选择Add JDK，然后从文件系统中选中你本机的JDK安装主目录（比如C:\Program Files\Java\jdk-17），IDEA会自动识别JDK版本号。
项目SDK配置：每个项目的独立选择
在同一个Project Structure窗口中，左侧点击Project，右侧的SDK下拉框里能看到所有已添加的JDK，选中一个后，IDEA会自动帮你把Language Level调整为该JDK对应的版本。Language Level决定了编译器对语法特性的接受程度，比如选17，就能用上sealed class这类新语法。
模块SDK配置：多Module工程的细分控制
如果你的项目是Maven或Gradle多模块结构,还可以针对每个模块单独指定SDK，点击Project Structure中的Modules，选中某个模块后，在右侧
Module SDK下拉框里选择，这一层级在事多人多的大工程里特别有用，比如底层模块用JDK 8，Web层用JDK 17。
建立JDK与构建工具的连接
即便IDEA界面全绿,如果不处理构建工具的JVM配置，编译时照样会闪红灯，这里单独拆开来细说，因为大部分实践中的JDK配置失败，都发生在这一环节。
Maven项目的JRE设置
使用Maven时,IDEA会调用外部Maven，这个过程依赖一个JAVA_HOME环境变量，如果你的系统里装了多个JDK，而环境变量指向旧版本，那IDEA项目里选再新的JDK也会在生命周期阶段报错。
解决方案是在IDEA的Settings > Build, Execution, Deployment > Build Tools > Maven > Runner中，看到JRE一栏，默认选的是Use Project JDK，建议勾选Use JAVA_HOME或直接手动选择你要用的那个JDK，这一步的配置经常被忽略，但它的优先级高于项目设置，直接影响mvn clean package的运行结果。
Gradle项目的JVM配置
Gradle构建脚本同样运行在独立的JVM上,这个JVM默认继承IDEA启动时用的JDK版本，在Settings > Build Tools > Gradle中，Gradle JVM下拉框可以选择Project JDK或其他任意已配置的JDK，当你发现Gradle同步时提示Unsupported class file major version，第一反应就应该是检查这个下拉框，把版本降到兼容范围，比如JDK 11或8，Gradle版本与JDK的兼容矩阵比较固化，如果本地同时跑了多个Gradle版本，配好这里的JVM选择能让项目少很多无谓的报错。
多版本JDK切换的正确方式
日常开发中,电脑里装了好几个JDK是常态，在主流的Java面试场景中这类问题也常被提及，切换这事，关键点在环境变量和IDEA内部设置两者之间的配合。
修改系统环境变量JAVA_HOME
如果你在终端里运行java -version，显示的版本永远取决于系统环境变量JAVA_HOME，Windows用户右键“此电脑”>属性>高级系统设置>环境变量；macOS用户编辑
~/.zshrc或~/.bash_profile文件，需要特别提醒的是，改完环境变量务必要重启IDEA，IDEA启动时只读取一次环境变量，不重启不生效，这也算一个高频踩坑点。
在IDEA内部快速切换项目JDK
如果是某个项目单独要用不同的JDK,不需要动环境变量，直接快捷键Ctrl+Alt+Shift+S打开项目结构，在Project标签下换SDK即可，IDEA会立刻重编译项目，这个过程比改环境变量要温和得多，如果你想全局默认都用某个新版本，那就在Settings > Build, Execution, Deployment > Compiler > Java Compiler里调整Project bytecode version，让它和语言级别匹配，避免出现编译产物版本混乱。
排查常见的JDK配置报错
配置完成后大概率会碰到几个高频报错,下面列出最常见的三种情况，基本覆盖了日常开发中的多数痛点。
- 错误显示“Cannot find JDK ‘xxx’ for module ‘yyy’”：出现这个提示，几乎可以断定是模块SDK指向了一个被删除的JDK路径，进入Project Structure > Modules，把Module SDK改为现有JDK，或者点加号重新添加路径就能解决。
- IDEA启动时根本无法运行，提示“No JVM found”：这种情况与IDEA设置无关，纯粹是系统找不到任何可用的JDK，需要先确保JDK成功安装，且环境变量JAVA_HOME已正确指向安装目录。
- Maven编译器版本报错（如“Source option 5 is no longer supported”）：这一般意味着构建工具使用了JDK内部的旧编译参数，在Maven的
pom.xml中检查maven-compiler-plugin配置，把source和target更新为当前JDK支持的版本，同时回到IDEA里确认Java Compiler的字节码版本与之一致。
处理IDEA缓存导致的配置不生效
有时设置明明全改好了,但代码仍然提示JDK错误，这大概率是IDEA的内部缓存惹的祸，试着执行
File > Invalidate Caches / Restart，并勾选Clear file system cache and Local History，重启后索引会重新构建，此时再查看项目结构，通常问题会自行消退，统计下来，一大批开发者的JDK配置问题其实都出在缓存这个环节。
两个容易忽略的细节
- IDEA本身的启动JVM：IDEA主程序运行在哪个JDK上，与你的项目SDK并没有直接关系，为了性能考虑，IDEA 2024.2及以后版本会优先使用自带的JetBrains Runtime，如果你手动修改了IDEA安装目录下的
idea64.exe.vmoptions，注意别把配置写错，否则可能影响启动。 - 配合使用Java版本管理工具：如果你经常需要在8、11、17、21之间来回横跳，更建议用SDKMAN（macOS/Linux）或
jEnv来管理命令行环境，这些工具能按目录自动切换JAVA_HOME，与IDEA内设置相互配合，能省下大量手工改环境变量的时间。
Q&A：关于idea中配置jdk的高频疑问
Q1：为什么我在idea配置了jdk，编译时还是报“程序包不存在”？
这个问题多半不在JDK,而在项目的依赖解析上，检查Maven或Gradle是否成功拉取了所有依赖，IDEA右侧的Maven面板刷新一下，如果依赖没问题，再看项目结构里每个模块的模块SDK是否都指向了正确的JDK，单改Project层级是不够的。
Q2：多个项目用不同版本的JDK，可以同时开着吗？
完全可以,IDEA支持同时打开多个项目窗口，每个项目独立使用自己的项目SDK，只要全局SDK列表里包含了所有需要的版本（比如JDK 8和JDK 17），每个窗口里选各自的就行，互不干扰。
Q3：idea配置jdk后一直提示“invalid source release: 17”，怎么处理？
这种提示通常出现在Project Structure里的Language Level已经设为17，但Java Compiler里的目标字节码版本还是5或8，进入Settings > Build, Execution, Deployment > Compiler > Java Compiler，在Per-module bytecode version中找到对应模块，把它调成和Language Level一致，再执行Maven的clean即可。