根本原因是Homebrew OpenJDK不注册到系统/usr/libexec/java_home目录，IDEA“自动探测”仅依赖该路径；即使java -version正常且JAVA_HOME已设，IDEA仍显示“No JDK specified”，必须手动在Project Structure中添加真实JDK路径/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home并确保模块Language Level匹配。
IntelliJ IDEA找不到Homebrew安装的OpenJDK
根本原因不是IDEA“不兼容”，而是Homebrew安装的OpenJDK默认不注册到系统Java虚拟机目录，/usr/libexec/java_home压根看不到它。IDEA在“自动探测JDK”时只查这个路径，所以即使java -version能正常输出，IDEA里仍显示“No JDK specified”。
验证方式：终端运行/usr/libexec/java_home -V，如果输出里没有openjdk@17或类似条目，就确认是这个问题。
- Homebrew OpenJDK不参与
java_home管理，这是设计使然，不是bug - 必须手动把JDK路径加进IDEA的SDK列表，不能依赖“自动发现”
- 路径不是
/opt/homebrew/opt/openjdk@17，而是其内部真实JDK根目录：/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home - 若用Apple Silicon（M1/M2/M3），确保路径中没有x86_64字样；Intel Mac则注意架构匹配
设置JAVA_HOME后IDEA仍用错版本
设置了JAVA_HOME，echo $JAVA_HOME也正确，但IDEA新建项目还是默认选JDK 8或报“UnsupportedClassVersionError”，说明IDEA没读取或没遵循这个环境变量——它只在启动时读一次，且仅用于自身JVM启动（即IDE运行环境），不控制项目编译/运行所用的JDK。
关键点：IDEA项目SDK和IDE自身JVM是两套独立配置，JAVA_HOME只影响后者。
- 检查IDEA是否从终端启动：直接双击App图标启动时，
JAVA_HOME对项目SDK无效；必须用open -a "IntelliJ IDEA"或终端执行idea命令启动，才能继承shell环境变量 - 即便启动方式正确，项目SDK仍需在
File → Project Structure → SDKs中显式添加并指定，不能只靠JAVA_HOME - Gradle/Maven项目还会优先读
pom.xml或build.gradle里的java.version，与IDEA设置冲突时以构建工具为准
Homebrew OpenJDK路径在IDEA中添加失败
点击+ → JDK，选中/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home后提示“Invalid JDK path”或灰掉“OK”按钮，大概率是路径末尾多了/bin或误选了jre子目录，也可能权限不足。
Homebrew OpenJDK的合法JDK根目录必须满足：包含bin/javac、lib/modules、release三个文件（夹）。
- 绝对不要选
/opt/homebrew/opt/openjdk@17（这是symlink，IDEA不认） - 不要选
.../openjdk.jdk/Contents/Home/jre（那是JRE，缺javac等开发工具） - 如果提示权限错误，先运行
ls -l /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home确认可读 - macOS Sonoma+系统可能因隐私限制阻止IDEA访问该路径，需在“系统设置→隐私与安全性→完全磁盘访问”中给IDEA授权
多个Homebrew JDK版本共存时如何切换
Homebrew不支持像SDKMAN!那样sdk use一键切换，每个openjdk@xx都是独立formula，路径互不干扰。IDEA里要为不同项目配不同JDK，靠的是项目级SDK绑定，而非全局切换。
实际操作中，你得为每个项目单独指定SDK路径，比如一个项目用openjdk@17，另一个用openjdk@21，路径分别是：
/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home/opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk/Contents/Home
- 不要试图用
brew unlink/link来“切换默认JDK”，这只会破坏当前shell的java命令，对IDEA无意义 - 如果频繁切换，建议在
~/.zshrc里用别名简化路径输入，例如alias jdk17="openjdk@17/libexec/openjdk.jdk/Contents/Home" - 最易被忽略的一点：模块Language Level（
Project Structure → Modules → Language Level）必须和所选JDK版本一致，否则即使SDK正确，也会报“不支持发行版本xx”
