这里有两种主要场景,我将为你详细说明:
- 为整个项目或模块设置 JDK
- 为 Maven/Gradle 项目设置 JDK (更常见)
为整个项目或模块设置 JDK
这种方法适用于普通的 Java 项目或不使用构建工具(如 Maven)的项目。
步骤 1:确保 JDK 已安装并被 IDEA 识别
在配置之前,你需要先确保目标版本的 JDK 已经安装在你的电脑上,IDEA 知道它的位置。

- 打开 IntelliJ IDEA。
- 进入
File->Project Structure...(快捷键:Ctrl+Alt+Shift+S)。 - 在左侧菜单中选择
Platform Settings->SDKs。 - 点击窗口左上角的 号,然后选择
Add JDK。 - 在弹出的文件选择器中,导航到你安装 JDK 的目录(
C:\Program Files\Java\jdk-17或/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home)。 - 选择后,IDEA 会将其添加到 SDK 列表中,你现在可以看到可用的 JDK 版本。
步骤 2:为项目指定 JDK
- 仍然在
Project Structure窗口中,选择左侧的Project Settings->Project。 - 在右侧的
Project SDK下拉菜单中,选择你刚刚添加的或想要更换的 JDK 版本。 - 下方的
Project language level通常会自动匹配 JDK 的版本,你也可以手动设置语言特性级别(即使使用 JDK 17,你也可以选择只使用 JDK 11 的语言特性)。 - 点击
OK保存配置。
为特定模块设置 JDK:
如果你的项目有多个模块,并且需要为其中一个模块设置不同的 JDK,你可以在 Project Structure -> Project Settings -> Modules 中,选择具体的模块,然后在右侧的 Dependencies 选项卡中为其选择 Module SDK。
为 Maven/Gradle 项目设置 JDK(推荐方法)
对于 Maven 或 Gradle 项目,最佳实践是在构建工具的配置文件(pom.xml 或 build.gradle)中指定 JDK 版本,IDEA 会根据这些文件的配置自动切换和下载对应的 JDK。
对于 Maven 项目
-
打开你的
pom.xml文件。 -
在
<properties>标签中设置 Java 版本:<properties> <maven.compiler.source>17</maven.compiler.source> <maven.compiler.target>17</maven.compiler.target> <!-- 或者使用新的 compiler 插件配置 --> <!-- <java.version>17</java.version> --> </properties>或者更详细地配置
maven-compiler-plugin:<build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.11.0</version> <configuration> <source>17</source> <target>17</target> <!-- 如果你想使用预览特性 --> <!-- <compilerArgs>--enable-preview</compilerArgs> --> </configuration> </plugin> </plugins> </build> -
保存
pom.xml后,IDEA 通常会自动检测更改并提示你导入更改(屏幕右下角),点击Import Changes。 -
IDEA 会根据
pom.xml中的配置自动调整项目使用的 JDK 和语言级别。
对于 Gradle 项目
-
打开你的
build.gradle或build.gradle.kts文件。 -
设置
sourceCompatibility和targetCompatibility:Groovy DSL (
build.gradle):plugins { id 'java' } java { sourceCompatibility = '17' targetCompatibility = '17' }Kotlin DSL (
build.gradle.kts):plugins { java } java { sourceCompatibility = JavaVersion.VERSION_17 targetCompatibility = JavaVersion.VERSION_17 } -
保存文件后,IDEA 会提示你刷新 Gradle 项目(屏幕右侧有一个 Gradle 大象图标),点击刷新按钮。
-
Gradle 会下载并配置相应的 JDK(如果使用工具链功能),IDEA 也会同步更新项目设置。
重要提示
- 重新加载项目: 在修改 Maven 的
pom.xml或 Gradle 的build.gradle后,务必点击 IDEA 的提示进行Import Changes或Reload,否则更改不会生效。 - JDK 与 JRE: 开发时请始终使用 JDK (Java Development Kit),因为它包含了编译和调试所需的工具(如
javac),JRE (Java Runtime Environment) 仅用于运行程序。 - 多个版本共存: 你可以在电脑上安装多个版本的 JDK,并在 IDEA 的
SDKs设置中全部添加,然后根据需要为不同的项目选择不同的版本。
对于现代 Java 项目,强烈推荐使用场景二(在 Maven/Gradle 配置文件中修改版本),这是最规范、最不容易出错的方式,IDEA 会完美地集成这些配置。