IntelliJ IDEA中配置Java SDK必须在Project Settings → Project（当前项目名下拉选中）中设置，而非全局或插件设置；若Project SDK不可选，需先在Modules中确认模块已加载；JDK路径须指向含bin、lib等子目录的根目录，不可选JRE或bin子目录；多模块项目以Modules中各模块的Module SDK设置为准，优先级高于Project SDK；Adoptium/Temurin可直接添加，GraalVM需确保含javac；环境变量不影响IDEA内部SDK选择，但影响Maven/Gradle。
找不到Project SDK选项？检查是否在正确设置层级
IntelliJ IDEA里配置Java SDK不是在“全局设置”或“插件设置”里，而必须进入项目级设置。常见错误是打开 File → Settings（Windows/Linux）或 IntelliJ IDEA → Preferences（macOS）后，在左侧选了 Editor 或 Plugins，结果根本看不到 Project SDK 字样。
正确路径是：Project Settings → Project（注意顶部下拉菜单是否选中了当前项目名）。只有这里才会显示 Project SDK 下拉框和 New... → JDK 按钮。
- 如果下拉框为空且不可点，说明当前没有加载任何模块——先确认
Project Settings → Modules中至少有一个模块被列出 - 如果用了Maven/Gradle导入项目，IDE通常会自动识别
pom.xml或build.gradle中的java.version并建议匹配SDK，但不会自动绑定，仍需手动选中
添加JDK时提示“Invalid JDK path”？验证目录结构是否合规
IDEA要求JDK路径必须指向包含 bin、jre（或 lib）、lib 子目录的根目录。比如你下载了 jdk-17.0.2 压缩包并解压，实际应选择 /path/to/jdk-17.0.2，而不是里面的 /path/to/jdk-17.0.2/bin 或 /path/to/jdk-17.0.2/jre。
典型错误路径：
立即学习“Java免费学习笔记（深入）”；
-
/usr/lib/jvm/java-11-openjdk-amd64/bin❌（多了/bin） -
C:\Program Files\Java\jre1.8.0_301❌（这是JRE，不是JDK；IDEA需要编译器支持，必须用JDK） -
~/Downloads/jdk-21.0.1.jdk/Contents/Home✅（macOS .jdk包需进到Home目录）
不确定是否有效？在终端执行 $JAVA_HOME/bin/java -version 和 $JAVA_HOME/bin/javac -version，两者都应成功输出版本号。
多个模块用不同JDK？Modules设置比Project设置更优先
一个项目可以有多个模块（如 core、web、test-utils），每个模块可独立指定SDK。此时 Project Settings → Modules → [模块名] → Sources 里的 Language level 和 Module SDK 才是真实生效项。
Project级SDK只是默认值，仅当模块未单独设置时才继承。这点容易被忽略，导致：
- 修改了Project SDK，但某个模块仍报
Cannot resolve symbol 'Optional'（因该模块还绑着Java 8） - Maven编译成功，但IDE内标红——因为IDE模块SDK没同步更新，和pom.xml里
<java.version>17</java.version>不一致
建议：对多模块项目，统一在 Modules 页逐一确认，别只改Project总览。
使用Adoptium/Temurin或GraalVM时要注意什么？
Adoptium（现Eclipse Temurin）和GraalVM的目录结构与Oracle JDK一致，可直接添加。但要注意：
- GraalVM CE版默认不带
javac，需额外安装gu install java（或下载含JDK的完整包），否则IDEA会提示Cannot find javac - Temurin 21+ 默认启用
--enable-preview，但IDEA不会自动加这个参数；若代码用了预览特性（如虚拟线程），需在Settings → Build → Compiler → Java Compiler中手动填入Additional command line parameters - 某些国产JDK（如毕昇JDK、龙芯JDK）可能缺少
src.zip或jmods，导致无法跳转源码或编译失败；遇到这类问题，优先换用Temurin官方构建
export JAVA_HOME=/home/user/jdk-17.0.2+8 export PATH=$JAVA_HOME/bin:$PATH
环境变量本身不影响IDEA内部SDK选择，但会影响Maven/Gradle插件调用的Java版本，所以建议保持一致。
真正容易卡住的，是模块SDK没设对，或者选了JRE当JDK——这两个点反复检查三遍，基本就通了。
