PhpStorm 运行缓慢90%源于缓存错乱或插件未真正退出，必须用“Invalidate and Restart”原子操作清空JVM内存状态和磁盘索引；仅Clear或仅Restart均无效，且需提前导出Keymap、Live Templates、Run Configurations等设置并手动备份keymap.xml和phpstorm64.vmoptions。
PhpStorm 运行缓慢，90% 不是软件坏了，而是缓存状态错乱或残留插件逻辑没真正退出——清缓存必须配合重启，且不能只点 “Clear”，得选 “Invalidate and Restart”。
为什么 Invalidate and Restart 不能拆开用
PhpStorm 的缓存分两层：JVM 内存里的运行时状态（比如已加载的组件、符号表快照），和磁盘上的索引文件（.idea 下的 index、caches）。只清磁盘缓存，内存里旧状态还在，跳转、补全、高亮仍走错误路径；只重启不清理，旧索引继续被读取，卡顿照旧。
- 选
Invalidate and Restart是原子操作，IDE 会先卸载所有组件、清空内存、删掉磁盘缓存，再以干净状态重进 JVM - 如果只点
Clear file system cache或Clear VCS log就 Cancel，等于什么都没做 - 某些插件（如
Laravel Plugin、PHP Annotations）的元数据只在重启后重新注入，不重启就看不到新注解解析效果
清缓存前必须导出的三样东西
执行 Invalidate and Restart 会清掉本地历史、断点、运行/调试配置、Live Templates 和快捷键映射。不提前备份，重装后要花半小时重配。
- 进
File → Manage IDE Settings → Export Settings，勾选Keymap、Live Templates、Run Configurations，导出为settings.jar - 手动备份
~/.PhpStorm2025.3/config/options/keymap.xml（macOS/Linux）或C:\Users\用户名\.PhpStorm2025.3\config\options\keymap.xml（Windows），这是最易丢的快捷键 - 如果用了自定义
phpstorm64.vmoptions，也一并复制出来——它不会被导出，但改错会导致启动失败
清完缓存还卡？检查 vendor 是否真被排除
缓存重建后仍卡顿，大概率是 vendor 或 node_modules 没被正确排除。它们不是“看起来大”，而是会持续占用 inotify 句柄、触发后台监听、拖垮索引速度。
立即学习“PHP免费学习笔记（深入）”；
- 右键项目根目录下的
vendor→Mark Directory as → Excluded（不是Ignored） - 进
Settings → Editor → File Types → Ignore files and folders，填入node_modules;vendor;dist;logs;storage/cache（注意分号分隔） - 如果用了 Composer path 仓库，进
Settings → Project → Project Structure → Modules，把对应路径重新设为Sources，否则跳转会失效 - 验证是否生效：打开
Help → Diagnostic Tools → Debug Log Settings，输入com.intellij.util.io.FileChannelUtil，重启后日志里不应再出现对vendor/autoload.php的频繁读取
清缓存后 vendor/autoload.php 还标红？不是缓存问题
这跟缓存无关，是 PhpStorm 没把 vendor 目录识别为源根（Sources Root），导致自动加载路径无法参与符号解析。即使你刚清过缓存、重启过，只要没手动标记，就会一直标红。
- 右键
vendor目录 →Mark Directory as → Sources（仅限你确定要让 IDE 解析 vendor 里的类，比如开发 Composer 包） - 更推荐做法：保持
vendor为Excluded，进Settings → PHP → Include Paths，把vendor/autoload.php手动加进去 - 确认 PHP 解释器路径正确：进
Settings → PHP，检查 CLI interpreter 是否指向真实环境（比如/usr/bin/php或 Docker 容器内路径），否则静态分析会漏判
真正耗时间的从来不是“清缓存”这个动作，而是判断哪些状态该留、哪些该扔——比如 Database Tools 插件禁用后不重启，进程还在后台跑；node_modules 加了 .gitignore 却没在 IDE 里 exclude，索引照常卡死。动手前先看一眼 Help → Diagnostic Tools → Debug Log Settings 里有没有异常日志，比盲目清缓存靠谱得多。
