idea如何设置jdk：分清三层配置

idea如何设置jdk分为全局SDK、项目SDK、模块SDK三层配置，全局SDK用来注册本机JDK路径，项目SDK控制整个工程默认编译版本，模块SDK可单独为子模块指定版本，你需要打开File‑Project‑Structure面板完成配置，导入Maven、Gradle项目时IDE会尝试自动读取pom或gradle配置，自动读取失效时必须手动修正模块SDK，JetBrains官方文档明确区分IDE自身启动运行时与项目开发JDK，IDE启动运行时不参与业务代码编译，不要混淆两者。该方法适用普通Java、Spring项目开发者，WSL跨文件系统开发场景下部分旧JDK版本会出现识别失败，不适用直接修改IDE启动运行时来改变项目编译JDK的场景。

idea设置jdk三层配置操作

打开File菜单选择ProjectStructure，快捷键Windows为Ctrl+Alt+Shift+S，Mac为Command+;。进入PlatformSettings下的SDKs页面，点击加号选择AddJDKfromdisk，选中本机JDK根目录，根目录内包含bin文件夹，不要选中bin子文件夹，完成后IDE就注册好了这个JDK，后续所有项目都可以直接选用该版本，没有本地JDK安装包，可在此面板选择DownloadJDK直接下载OpenJDK发行版。

切换到ProjectSettings的Project选项卡，在SDK下拉列表选择已经注册完成的JDK，同时把Projectlanguagelevel与JDK版本对齐，语言版本低于JDK会限制语法特性，高于JDK版本会直接报编译错误，点击Apply保存项目级别的SDK配置，这一步只对当前打开项目生效，新建项目不会继承该配置。

进入Modules选项卡，选中需要调整的模块，在ModuleSDK下拉选择目标JDK，模块SDK优先级高于项目SDK，同一工程内不同模块可以使用互不相同的JDK版本，多模块项目如果只设置项目SDK，部分子模块依旧沿用旧版本，代码编译会出现版本不兼容报错。

路径选错，会提示目录不是有效JDK主目录。

Maven、Gradle导入项目，即使已经设置好IDE内SDK，构建工具自身还会独立指定JDK，Maven读取pom.xml的maven‑compiler‑plugin配置，Gradle读取build.gradle内sourceCompatibility，两处配置和IDE的SDK版本不一致，运行就抛出UnsupportedClassVersionError类版本不匹配异常，代码编辑器不报错，但启动程序直接失败。

idea设置jdk不同方案对比

语言等级需要与实际使用JDK保持匹配，Java8对应languagelevel8，Java17对应languagelevel17，启用预览语法时选择带Preview后缀的语言等级，预览语法不建议用于生产业务代码，只适合学习测试场景。

配置完成后，你可以打开Run‑EditConfigurations，查看运行配置内的JRE选项，运行配置如果手动指定了独立JRE，会覆盖模块SDK，部分老项目导入后运行配置会保留旧JRE，即使SDK全部改完依旧版本错乱，需要同步更新运行配置的JRE。

全部设置结束后，执行Build‑RebuildProject，触发完整重新编译，缓存残留会导致修改SDK后旧编译产物依旧生效，Rebuild会清理旧产物，让新JDK配置完整落地。