应通过Help → Edit Custom VM Options打开用户配置目录下的真实生效文件，而非手动修改安装目录bin中的模板；JetBrains Toolbox用户须优先检查~/.cache/JetBrains/Toolbox/apps/PhpStorm/ch-0/路径。
怎么找到真正生效的 phpstorm64.vmoptions 文件
改错文件位置是 90% 内存设置不生效的根源。JetBrains 自 2020.3 起默认使用独立用户配置目录，安装目录 bin/ 下的 phpstorm64.vmoptions 只是模板，不会被读取。
正确做法是：在 PhpStorm 中点击 Help → Edit Custom VM Options。这个操作会自动在用户配置目录下创建或打开真实生效的文件，路径如下：
- Windows：
%APPDATA%\JetBrains\PhpStorm<version>\phpstorm64.exe.vmoptions</version> - macOS：
~/Library/Caches/JetBrains/PhpStorm<version>/phpstorm.vmoptions</version> - Linux：
~/.cache/JetBrains/PhpStorm<version>/phpstorm.vmoptions</version>
如果你用 JetBrains Toolbox 管理 PhpStorm，优先检查：~/.cache/JetBrains/Toolbox/apps/PhpStorm/ch-0/phpstorm64.vmoptions——它会覆盖所有其他路径。
别手动去 /opt/phpstorm/bin/ 或 C:\Program Files\JetBrains\... 改，除非你确认自己用的是“直接解压运行版”且没装 Toolbox。
立即学习“PHP免费学习笔记（深入）”；
哪些参数必须设、哪些绝对不能碰
核心就三个参数要调：-Xms、-Xmx、-XX:+UseG1GC。其他多数可不碰，乱加反而导致启动失败或 GC 不稳。
-
-Xms和-Xmx建议设为相同值（比如都写成-Xms2048m -Xmx2048m），避免运行中堆扩容带来的卡顿抖动 - 数值不是越大越好：
– 8GB 物理内存机器，-Xmx别超1536m
– 16GB 机器，-Xmx3072m是安全上限（官方明确警告：别设-Xmx4096m以上）
– 总量别超过物理内存的 50%～70%，否则系统 swap 频繁，IDE 更卡 - 必须加上
-XX:+UseG1GC：这是 JDK 11+ 下最适配 IDE 的垃圾回收器，比旧的-XX:+UseConcMarkSweepGC更稳 - 删掉
-XX:MaxPermSize：PhpStorm 2021.3+ 全部用元空间（Metaspace），写上直接报错
改完为什么还是卡？常见重启误区
JVM 参数在进程启动时就锁死了，File > Reload project from disk 或 Invalidate Caches and Restart 完全不触碰 JVM 层，等于白改。
- 必须彻底退出 PhpStorm 进程：右键托盘图标 → Exit（Windows/macOS），或用
ps aux | grep phpstorm+kill（Linux）确保无残留 - 如果用 Toolbox，改完后别忘了点右上角的 Restart 按钮——它只写配置，不自动重启旧进程
- 检查是否被环境变量干扰：启动日志里若出现
Picked up _JAVA_OPTIONS，说明系统级_JAVA_OPTIONS覆盖了你的设置，得删掉对应 export
验证是否生效：启动后右下角状态栏右键 → Memory Indicator；再打开 Help > Diagnostic Tools > Debug Log Settings，搜 VM options，确认日志打印的和你写的完全一致。
顺手加两行能防插件崩溃的配置
除了堆内存，JIT 编译缓存和元空间也容易出问题，尤其装了 Vue、PHPStan、Psalm 等重型插件时：
- 加一行
-XX:ReservedCodeCacheSize=512m：防止插件多导致 JIT 缓存溢出，报java.lang.OutOfMemoryError: Compressed class space - 加一行
-XX:MaxMetaspaceSize=512m：虽然 PhpStorm 默认不限制元空间，但大项目加载大量类时可能失控，设个上限更稳
这两行不是必须，但加了几乎零成本，且能避开一些冷门但难排查的崩溃场景——很多人卡在“某天突然打不开项目”，最后发现只是没加 ReservedCodeCacheSize。
