必须选“Invalidate and Restart”才真正生效，因仅Invalidate不释放内存中已加载的符号索引、类型推断上下文等；大项目可先用Cache Recovery修复，vendor问题需检查autoload、标记Sources Root及同步composer.json。
为什么只点 Invalidate 不重启等于白干
PhpStorm 的缓存是 JVM 内存驻留 + 磁盘文件混合结构。Invalidate Caches 操作本身只是标记缓存为“失效”，并不释放内存中已加载的符号索引、类型推断上下文或插件元数据。你如果点了 Invalidate 后手动关掉弹窗、或者只勾选了 Clear file system cache 就点 Cancel，IDE 依然在用旧状态工作——跳转错乱、Ctrl+Click 失效、注解不解析，全都会继续发生。
必须选 Invalidate and Restart：这是原子操作，重启时 JVM 重新加载，所有缓存重建才真正生效。尤其当你刚改过 PHP 解释器路径、启用了 Laravel Plugin 或更新了 composer.json，不重启就看不到变化。
什么情况下不该用 Invalidate and Restart
大项目（比如 vendor 超过 5 万文件）全量重建索引可能耗时 5–10 分钟，而你只是某几个类标红、Find Usages 返回空、或者新写的 trait 突然不被识别——这时候该用更轻量的修复方式：
-
File → Cache Recovery → Repair IDE：它分三步执行，且可单独控制 - 第一步「刷新虚拟文件系统」能立刻解决 NFS 挂载中断、文件权限突变导致的“文件存在但读不到”假象
- 第二步「重新扫描项目索引」默认跳过
vendor目录，只处理修改过的.php和.inc文件，速度比全量重建快 3–5 倍 - 第三步「删除共享索引」仅影响 PhpStorm 2025.1+ 的远程 Composer 包索引服务，本地项目可忽略
清理插件残留比清缓存还容易漏掉
卸载插件后，.jar 文件删了，但配置和缓存还在，可能导致下次启动卡顿、报错或功能异常。关键路径要手动扫一遍：
立即学习“PHP免费学习笔记（深入）”；
- 插件安装目录：
~/.phpstorm/config/plugins（macOS/Linux）或C:\Users\用户名\.phpstorm\config\plugins（Windows），删掉对应文件夹或.jar - 配置残留：
~/.phpstorm/config/options/settingsplugins.xml，打开检查是否还有已卸载插件的条目 - 缓存残留：
~/.phpstorm/system/caches，直接清空整个目录最稳妥（重启后自动重建） - 日志里常藏线索：
~/.phpstorm/system/log，搜PluginException或插件名，确认是否还在尝试加载
vendor 目录识别失败？别急着 Invalidate
很多“类找不到”“命名空间标红”问题，根源不在缓存，而在 vendor 没被正确纳入索引范围：
- 先确认
vendor/autoload.php存在且可读，运行composer dump-autoload -o强制刷新自动加载映射 - 右键
vendor目录 →Mark Directory As → Sources Root，这是让 PhpStorm 把它当源码处理的关键动作 - 检查
Settings → Directories，确保vendor没被标成Excluded（红色图标） - 再点
Synchronize PHPStorm with composer.json（在Settings → Languages & Frameworks → PHP → Composer里），强制重读依赖关系 - 最后才考虑
Invalidate and Restart——多数时候，做完前三步就恢复了
真正麻烦的从来不是缓存本身，而是你以为清了缓存就万事大吉，却漏掉了插件残留、vendor 标记、或解释器配置没同步这些更底层的环节。
