IDEA启动慢或报OutOfMemoryError需区分平台JVM（影响IDE自身）和项目JVM（影响运行代码），平台参数在Help→Edit Custom VM Options修改，项目参数在Run→Edit Configurations→VM options设置；Gradle构建OOM则需配置gradle.properties中的org.gradle.jvmargs。
IDEA 启动慢或运行时抛 OutOfMemoryError: Java heap space 怎么调？
直接调 -Xmx 不一定管用，IDEA 自身有两套 JVM：一个是启动 IDEA 的「平台 JVM」，另一个是运行你项目的「项目 JVM」。搞混这两者，调了也白调。
常见错误现象：OutOfMemoryError: Java heap space 出现在运行 Spring Boot 项目时；或者 IDEA 编译卡死、卡在 “Indexing…”；甚至打开设置窗口都卡顿。
- 平台 JVM 参数在
Help → Edit Custom VM Options…里改，影响 IDEA 自身（含插件、索引、UI） - 项目 JVM 参数在
Run → Edit Configurations… → Environment → VM options里设，只影响你跑的代码 - Mac 用户注意：
idea.vmoptions文件默认藏在~/Library/Application Support/JetBrains/IntelliJ IDEA XXX/下，不是安装目录里的那个
怎么判断该调哪个 JVM 的堆内存？
看错误发生时机和位置。IDEA 自身崩溃、卡在扫描文件、无法打开 Maven 面板 → 是平台 JVM 不够；你点 Run 按钮后几秒报错 → 大概率是项目 JVM 堆溢出。
快速验证方法：在终端里运行 jps -l，再对每个 PID 执行 jstat -gc <pid>，观察 heap used 和 max 的比值。如果 IDEA 主进程（通常是 com.intellij.idea.Main）的 used 接近 max，就该调平台参数。
- 平台 JVM 建议起始值：
-Xms2g -Xmx4g（16G 内存机器），别超过物理内存的 50% - 项目 JVM 别盲目拉高，Spring Boot 默认
-Xmx512m足够，大项目才需加到-Xmx2g - 加
-XX:+UseG1GC比默认 GC 更稳，尤其在堆 > 4G 时
-Xmx 调太大反而更卡？为什么
堆设得远超实际需要，GC 周期变长、单次暂停时间飙升，IDEA 界面会“间歇性失联”——比如你敲代码时编辑器突然停住 1–2 秒，就是 G1 或 Parallel GC 在做全堆回收。
典型症状：CPU 不高，但响应延迟明显；jstat 显示 G1 Young Generation GC 频率低但每次耗时 >300ms；日志里反复出现 GC pause (G1 Evacuation Pause)。
- 不要设
-Xmx8g在 16G 机器上跑小项目——系统没多少空闲内存留给文件缓存和 IDE 渲染线程 - 用
-XX:+PrintGCDetails -Xloggc:gc.log开启 GC 日志，比凭感觉调靠谱得多 - Windows 上如果用了 WSL2，IDEA 运行在 Windows，但项目连 WSL2 的数据库或服务，网络+GC 双重压力下，
-Xmx1g可能比-Xmx3g更流畅
Gradle 构建时报 OutOfMemoryError 怎么办？
这是独立于 IDEA 的第三套 JVM：Gradle Daemon 进程。IDEA 默认复用它，所以即使你调了 IDEA 和项目参数，构建仍可能崩。
错误信息明确带 org.gradle.api.internal.project.DefaultProject 或出现在 Build → Build Project 过程中，基本就是它。
- 在
gradle.properties里加：org.gradle.jvmargs=-Xmx2g -XX:MaxMetaspaceSize=512m - IDEA 中关掉
Settings → Build → Build Tools → Gradle → Run tests using的 “Gradle Test Runner”，避免测试占用额外堆 - 执行
./gradlew --stop杀掉旧 Daemon，再构建，确保新参数生效
真正麻烦的是混合场景：比如你同时开 IDEA、Chrome、Docker Desktop，再跑一个本地 Kafka + ZooKeeper，这时候堆参数只是表象，内存争抢才是根因。盯紧系统级内存水位，比死磕 -Xmx 更有效。
