IntelliJ IDEA 是用 Java 编写的独立 IDE,需先安装 JDK 17 或 21(LTS),再安装 IDEA 并手动配置 Project SDK 路径;启动失败或报错多因 JDK 版本不匹配、路径错误或架构不符,应检查 java -version、SDK 根目录及系统架构。

IntelliJ IDEA 不是“安装在 Java 里”的工具,它本身是用 Java 写的独立 IDE,运行依赖本地已安装的 JDK —— 所以你真正要做的,是先装好 JDK,再装 IDEA,并让 IDEA 知道该用哪个 JDK。
确认并安装合适版本的 JDK
IntelliJ IDEA 自 2022.1 起不再自带 JDK,必须手动提供。最新稳定版 IDEA(如 2024.x)推荐使用 JDK 17 或 JDK 21(LTS 版本),不建议用 JDK 8 或 JDK 11 运行新版本 IDEA(可能启动失败或功能受限)。
- 去 Eclipse Temurin 或 Oracle JDK 下载
jdk-17.0.x或jdk-21.0.x的安装包(注意选对操作系统和架构,比如 Windows x64 / macOS ARM64) - 安装时记下 JDK 安装路径,例如:
C:\Program Files\Eclipse Adoptium\jdk-17.0.11.9-hotspot\(Windows)或/Library/Java/JavaVirtualMachines/jdk-21.0.3.jdk/Contents/Home(macOS) - 安装完成后,在终端执行
java -version和javac -version,确保输出一致且版本号 ≥ 17
下载并运行 IntelliJ IDEA
官网下载的是自解压安装包或 dmg/pkg 安装器,不是 Maven 依赖,也不需要“用 Java 命令安装”。直接运行即可,无需配置 CLASSPATH 或修改 Java 环境变量来启动 IDEA。
- 从 jetbrains.com/idea/download 下载
IntelliJ IDEA Community(免费开源)或Ultimate(付费,支持 Spring、数据库等) - Windows:运行
ideaIC-2024.2.exe,勾选 “Add launchers to the PATH” 可在命令行直接输入idea启动 - macOS:拖拽
IntelliJ IDEA.app到Applications文件夹,首次运行需右键 → “打开” 绕过 Gatekeeper - Linux:解压
ideaIC-2024.2.tar.gz到任意目录,运行bin/idea.sh
首次启动后配置 Project SDK
IDEA 启动后新建项目时,默认可能提示 “No SDK”,这是因为它没自动找到你装的 JDK —— 必须手动指定 Project SDK,否则连 main 方法都标红、无法编译。
立即学习“Java免费学习笔记(深入)”;
- 新建项目 → 左侧选
Java→ 右侧确保Project SDK下拉框显示 “No SDK”,点击右侧New...→JDK - 在弹出窗口中,定位到你之前安装的 JDK 根目录(即包含
bin/和lib/的那一层),例如:/home/user/jdk-21.0.3,不要选到.../jre或.../Contents/Home/jre - 确认后,IDEA 会自动加载
rt.jar(或模块化后的java.base等);此时新建的HelloWorld.java就能正常识别String、System.out等基础类 - 如果已有项目打不开,右键项目名 →
Open Module Settings→Project标签页 → 修改Project SDK和Project language level(建议与 JDK 版本一致,如 JDK 21 对应21 (Preview) - Pattern Matching for switch)
常见报错与绕过方式
最常卡在启动阶段或新建项目时报错,本质都是 JDK 路径或版本不匹配。别急着重装,先看错误信息关键词:
-
UnsupportedClassVersionError: ... major.minor version 65→ IDEA 用 JDK 21 编译,但你给它配了 JDK 17,换更高版本 JDK -
Failed to load JVM DLL(Windows)→ 路径含中文或空格,或选错了jre/子目录;改用纯英文路径重新指定 SDK - macOS 上提示 “The JVM shared library does not contain the JNI_CreateJavaVM symbol” → 下载的是 JRE 而非 JDK,或架构不匹配(如在 Apple Silicon 上用了 x64 JDK);换用
ARM64版 Temurin JDK - IDEA 启动后界面空白或卡死 → 检查是否禁用了硬件加速;启动时加参数:
Help → Edit Custom VM Options...,追加一行-Dsun.java2d.metal=false(macOS Sonoma+ 常见)
# # idea.vmoptions 示例(位于 IDEA 安装目录 bin/ 下) # -Xms128m -Xmx2048m -XX:ReservedCodeCacheSize=512m -Dsun.java2d.metal=false
SDK 配置不是一次性的——不同项目可能依赖不同 JDK(比如老系统用 JDK 11,新模块用 JDK 21),每次新建项目都要检查 Project SDK 下拉框,别依赖“上次设置”。










