核心三步:确认本地jdk已安装并找到正确根目录(如windows的c:\program files\java\jdk-17、macos的/library/java/javavirtualmachines/jdk-17.jdk/contents/home)、在project structure中手动指定该路径并同步设置project language level、多模块项目需在modules中为各模块单独配置module sdk及对应语言级别。

直接在 IntelliJ IDEA 里指定 JDK 路径,核心就三步:确认本地 JDK 已装好、手动选对根目录、同步语言级别。别指望 IDEA 自动识别,尤其 macOS 和 Windows 非管理员安装时,它常静默失败。
确认 JDK 已安装并找到正确路径
打开终端(Windows 用 cmd 或 PowerShell,macOS/Linux 用 Terminal),运行:
java -version
有输出类似 openjdk version "17.0.2" 就说明装好了。接着找安装目录:
- Windows:通常是 C:\Program Files\Java\jdk-17(注意别选 jre 子文件夹)
- macOS:/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
- Linux:用 update-java-alternatives -l 查,常见路径如 /usr/lib/jvm/java-17-openjdk-amd64
路径里避免空格和中文;若含空格(如 Program Files),可尝试用短路径(C:\Progra~1\Java\jdk-17)或换到 D:\jdk17。
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
在 IDEA 中设置项目级 JDK
打开项目后,按 Ctrl+Alt+Shift+S(Windows/Linux)或 Cmd+; (macOS)调出 Project Structure:
- 左侧选 Project,右侧看 Project SDK
- 若为空,点 New → JDK,然后浏览到上面确认的 JDK 根目录(不是 bin,不是 jre,是包含 bin、lib、jmods 的那层)
- 选中后,再检查 Project language level 是否与 JDK 版本一致(JDK 17 就选 17,不能留成 8)
- 点 Apply,不是只点 OK —— 只点 OK 不生效
多模块项目要单独配 Module SDK
如果项目含多个模块(比如 api、service、test),且需要不同 JDK(如测试模块用 JDK 11,主模块用 JDK 17):
- 在 Project Structure 中选左侧 Modules
- 逐个点开模块,在 Dependencies 标签页下,找到 Module SDK
- 为每个模块单独选对应 JDK,并同步调整其 Language level
- 默认不继承 Project SDK,必须手动设,否则仍用旧版本
顺手检查运行配置和构建工具
就算项目 SDK 设对了,程序也可能跑不起来,因为:
- 右上角运行配置下拉菜单 → Edit Configurations → 检查 JRE 是否选“Project default”或明确指向目标 JDK
- Maven 项目:确认 pom.xml 里的
<source>17</source>和<target>17</target>匹配 - Gradle 项目:检查 gradle.properties 或 build.gradle 中
sourceCompatibility = JavaVersion.VERSION_17 - IDEA 自身构建工具(如 Maven Settings):File → Settings → Build → Build Tools → Maven → Maven home path 下的 Runner → JRE 也要设对
不复杂但容易忽略
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










