IDEA中Project SDK为空需先验证JDK真实存在并获取正确路径，再在Project Structure中手动添加JDK根目录；还需检查Module SDK继承关系、Language Level匹配、构建工具配置及无效SDK清理。
IDEA里找不到Project SDK选项
新装IDEA或刚导入项目时，File → Project Structure → Project 页面中 Project SDK 下拉框为空，甚至显示 No SDK。这不是项目坏了，而是IDEA根本没识别到本地已安装的JDK。
解决路径很直接：先确认JDK是否真实存在且可执行，再手动指向它。
- 在终端运行
java -version和which java（macOS/Linux）或where java（Windows），看输出的路径是否指向jdk-xx目录（而非jre或仅bin） - 若用SDKMAN!管理JDK，路径通常是
~/.sdkman/candidates/java/current；若用Homebrew，常见路径是/opt/homebrew/opt/openjdk/libexec/openjdk.jdk（Apple Silicon）或/usr/local/opt/openjdk/libexec/openjdk.jdk（Intel） - 在IDEA中点击
Project SDK → Add SDK → Add JDK，然后选择JDK根目录（含bin、lib、jre的那一层），不是选bin/java文件本身
配置完SDK后模块仍报“Cannot resolve symbol”
即使全局SDK设对了，单个模块（Module）可能仍用着旧的或空的SDK，导致类无法识别、Maven依赖不生效、Lombok失效等现象。
关键点在于：IDEA里SDK分两级——Project级和Module级，后者会继承前者，但可被单独覆盖。
立即学习“Java免费学习笔记（深入）”；
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 进入
File → Project Structure → Modules，检查每个模块的Module SDK是否为Inherit project SDK，或明确指向你刚配好的JDK - 如果模块是Maven项目，确认
pom.xml中的<java.version></java.version>与SDK版本兼容（例如设了17，但SDK是JDK 21，部分插件会拒绝编译） - 特别注意：添加新模块（如通过
File → New → Module）时，IDEA默认不会自动继承Project SDK，必须手动设置
使用不同JDK版本时出现“Unsupported class file major version”错误
运行或编译时报错 java.lang.UnsupportedClassVersionError: Unsupported class file major version xx，本质是字节码版本不匹配——比如用JDK 17编译的类，却在JDK 11上运行。
这通常不是SDK路径配错了，而是编译输出级别（bytecode version）和运行环境脱节了。
- 在
Project Structure → Project中，除了Project SDK，还要核对Project language level是否与SDK匹配（JDK 17 对应 Language level 17） - 在
Project Structure → Modules → Sources标签页，检查Language level是否一致；在Paths标签页，确认Output path没被其他构建工具（如Gradle）覆盖 - 如果是Gradle项目，还需同步
gradle.properties中的org.gradle.java.home和build.gradle里的java.toolchain.version，否则IDEA的SDK设置只是“看起来有效”
SDK列表里显示多个重复JDK或灰色不可用项
在 Add SDK → JDK 浏览时，看到好几个名字一样但路径略异的JDK，或者某些条目带灰色禁用图标（如 corretto-11 (invalid)），说明IDEA检测到了损坏、权限不足或结构异常的JDK安装。
这类残留SDK不会影响当前项目，但会干扰选择，也反映系统环境可能混乱。
- 不要手动删文件系统里的JDK目录来“清理”，而应在IDEA中右键灰色SDK →
Remove，再重启IDEA - 若某JDK路径下缺失
lib/rt.jar（JDK 8）或lib/modules（JDK 9+），IDEA会判为无效；OpenJDK精简版（如Alpine镜像中的）常缺这些，不能直接用作IDEA SDK - Windows用户注意：以管理员身份运行IDEA可能导致SDK路径写入注册表权限位置，普通启动时读不到；统一用非管理员方式打开IDEA更稳妥
SDK路径本身只是起点，真正起作用的是IDEA如何用它去解析语法、调用编译器、加载标准库。很多问题表面是“路径没配对”，实际卡在语言级别、模块继承、构建工具同步这三个隐性环节上。
