17370845950

IntelliJ IDEA、Eclipse、VS Code 中 JDK 路径需手动配置且四者（IDE SDK、构建路径、java.home、构建工具）必须一致，否则导致编译报错或运行时异常。

IntelliJ IDEA 里 JDK 路径没生效？检查 project structure 和 SDKs 两处设置

IDEA 不会自动继承系统 JAVA_HOME 或 PATH 中的 JDK，必须手动指定。常见现象是：编译报错 Cannot resolve symbol 'List'，或运行时提示 Unsupported class file major version——这说明项目用的 JDK 版本和代码语言级别不匹配。

• File → Project Structure → Project：确认 Project SDK 已选中正确 JDK（如 17），且 Project language level 与之兼容（如 JDK 17 对应 17 (Preview) - Sealed types）
• File → Project Structure → Platform Settings → SDKs：这里要看到你添加的 JDK 根目录（如 /Library/Java/JavaVirtualMachines/jdk-17.0.1.jdk/Contents/Home），不是 jre 子目录，也不能指向 bin 或 java 可执行文件
• 如果 SDK 列表为空，点 + → Add JDK，直接选中 JDK 安装根目录（macOS 是 Contents/Home，Windows 是解压后的顶层文件夹）

Eclipse 中 Build path → Configure Build Path 里 JDK 选错会导致 Maven 编译通过但 IDE 报红

Eclipse 的 Java 构建路径和 Maven 的 java.version 是两套逻辑。即使 pom.xml 设了 17，IDE 若仍用内置 JRE（如 jre-11），就会标红 var、sealed 等语法。

• 右键项目 → Properties → Java Build Path → Libraries：展开 JRE System Library，确认右侧显示的是你期望的 JDK（如 JavaSE-17），不是 jre11 或 Execution Environment
• 若显示为 Alternate JRE 但路径不对，点 Edit… → Workspace default JRE 或手动 Add External JRE，指向完整 JDK 目录（非 jre/ 子目录）
• 同时检查 Preferences → Java → Installed JREs，确保列表中有你安装的 JDK，并勾选为默认

VS Code + Java Extension Pack 依赖 java.home 配置，路径格式错误直接导致 Language Server 启动失败

VS Code 的 Java 支持靠 redhat.java 扩展驱动，它需要明确知道 JDK 位置。配置错会导致“Loading Java Projects…” 卡住、无代码补全、跳转失效。

• 打开设置（Cmd+, 或 Ctrl+,），搜索 java.home，设为 JDK 根路径（如 /opt/java/jdk-17.0.2）
• Windows 用户注意：路径中不能含空格或中文；若用 Chocolatey 安装，路径类似 C:\\ProgramData\\chocolatey\\lib\\openjdk\\tools\\openjdk\\，末尾不要加 bin 或 java.exe
• 验证方式：打开命令面板（Cmd+Shift+P），运行 Java: Show Java Home，输出应为完整 JDK 根目录
• 若使用多个 JDK，可在项目根目录加 .vscode/settings.json 单独指定：

  {"java.home": "/path/to/jdk-17"}

Maven 和 Gradle 的 sourceCompatibility 与 IDE 的 JDK 设置不一致，会引发运行时异常

IDE 只负责编辑和编译提示，真正打包和运行由构建工具控制。比如 IDEA 设了 JDK 17，但 pom.xml 中 maven-compiler-plugin 的 source 和 target 写成 11，代码里用了 switch expressions，IDE 不报错，但运行时可能抛 UnsupportedClassVersionError。

• Maven 示例（必须与 IDE 设置对齐）：

  
    org.apache.maven.plugins
    maven-compiler-plugin
    3.11.0
    
      17
      17
    
  

• Gradle 示例：

  java {
      sourceCompatibility = JavaVersion.VERSION_17
      targetCompatibility = JavaVersion.VERSION_17
  }

• 更稳妥的做法：在 IDEA 中启用 Build project automatically，并勾选 Delegate IDE build/run actions to Maven/Gradle，让构建逻辑完全由工具链接管

IDE 对 JDK 的识别不是“配一次就一劳永

逸”。换 JDK 版本、切换项目、更新插件后，都要重新核对 SDKs、Build Path、java.home 和构建脚本四者是否指向同一套 JDK——漏掉任意一环，都可能让语法高亮正常但运行崩溃。