intellij idea 在 mac 上确认当前 jdk 版本需进入 file | project structure（cmd ;），查看 project sdk 是否显示具体版本或路径（如 /opt/homebrew/opt/openjdk@21）；若为空则需通过 add sdk | jdk 手动指定 jdk 根目录（含 contents/home 或 lib），避免选错架构或含空格路径；模块 sdk 和语言级别须单独配置且与代码语法匹配，编译输出路径应指向 maven 的 target/classes 或 gradle 的 build/classes/java/main 以确保运行时类加载正确。
Mac 上 IntelliJ IDEA 的项目结构配置，核心是搞清「项目 SDK」「模块 SDK」「语言级别」和「编译输出路径」这四件事。配错一个，就会出现 Cannot resolve symbol、Unsupported class file major version 或运行时报 NoClassDefFoundError —— 这些不是代码问题，而是结构没对齐。
怎么确认当前项目用的是哪个 JDK？
别只看终端里 java -version 的输出，IDEA 自己有一套独立的 JDK 管理逻辑：
- 打开
File | Project Structure（快捷键Cmd ;），左侧选 Project → 右侧看 Project SDK 下拉框：如果显示17、21或具体路径（如/opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk），说明已识别；若为空或显示No SDK，必须手动添加 - 点旁边的
Edit...，再点Add SDK | JDK，选你本地 JDK 的根目录（不是bin，是包含Contents/Home或lib的那一层） - 注意：Mac 上通过 Homebrew 安装的 OpenJDK，路径通常是
/opt/homebrew/opt/openjdk@21或/usr/local/opt/openjdk@17；Apple Silicon 机器上不要选 x86_64 版本的 JDK，否则编译会卡在javac启动阶段
模块（Module）的 SDK 和语言级别为什么不能直接继承项目？
因为模块可以独立编译，且不同模块可能依赖不同版本的库（比如一个模块要兼容 Java 8 运行时，另一个要用 Java 21 的 VirtualThread）。常见踩坑点：
- 新建模块后，默认
Module SDK是Project SDK，但Language level有时会回退成6或8，导致新语法（如var、record）标红 - 在
Project Structure | Modules里选中模块 → Dependencies 标签页 → 检查Module SDK是否为有效值；再切到 Sources 标签页 → 确认Language level和你写的代码匹配（比如用了switch表达式，就得设为14+） - 如果模块是 Maven 导入的，IDEA 通常会自动同步
pom.xml里的<maven.compiler.source></maven.compiler.source>和<maven.compiler.target></maven.compiler.target>，但仅当勾选了Delegate IDE build/run actions to Maven才真正生效（在Preferences | Build, Execution, Deployment | Build Tools | Maven | Runner）
编译输出路径（Output path）设错会导致什么？
Mac 用户最容易忽略的一点：默认输出路径是 out，但它不等于 Maven 的 target，也不等于 Gradle 的 build。后果很直接：
- 运行时找不到类 —— 因为
Run Configuration默认从out/production加载 class，而你实际编译产物在target/classes - 修改代码后热更新失效 —— IDEA 监控的是
out目录，但构建工具往target写 - 解决办法：如果是 Maven 项目，在
Project Structure | Modules | Paths里，把Output path改成$MODULE_DIR$/target/classes，Test output path改成$MODULE_DIR$/target/test-classes；Gradle 项目同理，指向build/classes/java/main - 注意路径变量写法：
$MODULE_DIR$是模块根目录，不是$PROJECT_DIR$；Mac 上路径分隔符用/，别用\
最麻烦的其实是「项目 SDK 和模块 SDK 不一致 + 语言级别未同步 + 输出路径指向错误」三者叠加——这时候报错信息往往不指向根源，而是表现为随机的符号解析失败或运行时异常。Mac 上尤其要注意 JDK 路径是否带空格、是否混用 Rosetta 和原生 ARM64 版本，这些细节在 Project Structure 里一眼就能验出来。
