Invalidate Caches 不重启无效，因 PhpStorm 缓存含 JVM 内存驻留与磁盘文件，仅标记失效不释放内存索引；唯一有效救急操作是 Invalidate and Restart。
只点 Invalidate Caches 不重启，跳转失效、标红、Ctrl+Click 失灵问题根本不会消失。 因为 PhpStorm 的缓存是 JVM 内存驻留 + 磁盘文件混合结构，Invalidate 操作只是打个“失效标记”，不释放内存里的符号索引、类型推断上下文和插件元数据——你看到的还是旧状态。
为什么 Invalidate and Restart 是唯一有效的救急操作
IDE 启动后，所有解析逻辑（类名跳转、@var 提示、Find Usages）都依赖内存中已加载的索引快照。仅清磁盘缓存而不重启，JVM 仍用着旧的符号表；新改的 composer.json 映射、刚启用的 Laravel Plugin、甚至刚更新的 PHP 解释器路径，全都不会生效。
- 点了
Invalidate Caches后手动关掉弹窗 → 缓存状态没变，问题照旧 - 只勾选
Clear file system cache就点Cancel→ 什么都没做 - PHP Interpreter 路径已更新，但
@var还报错 → IDE 仍在用旧解释器参与静态分析 - 刚运行过
composer dump-autoload -o，但新命名空间类仍标红 → 插件元数据没刷新，得靠重启重载
大项目卡在重建索引？先试 Cache Recovery
如果你只是某几个类跳不到定义、Find Usages 返回空、新写的 trait 不被识别，且项目含大量 vendor（比如 >5 万文件），直接 Invalidate and Restart 可能要等 5–10 分钟。这时更轻量的修复路径是：
- 菜单栏 →
File→Cache Recovery→Repair IDE - 第一步「刷新虚拟文件系统」：立刻解决 NFS 挂载中断、权限突变导致的“文件存在但读不到”假象
- 第二步「重新扫描项目索引」：默认跳过
vendor，只处理修改过的.php和.inc，速度比全量快 3–5 倍 - 第三步「删除共享索引」：仅影响 PhpStorm 2025.1+ 的远程 Composer 包索引服务，本地项目可忽略
vendor/autoload.php 标红？这不是缓存问题，是配置漏了
缓存清得再干净，vendor/autoload.php 如果没被 PhpStorm 当作自动加载入口，第三方类和自定义包照样标红。必须手动补上三步：
立即学习“PHP免费学习笔记（深入）”；
- 右键
vendor目录 →Mark Directory as→Excluded（避免扫描拖慢索引） - 右键
vendor/autoload.php→Mark as PHP Include Root（明确告诉 IDE 这是加载起点） - 进
Settings → Languages & Frameworks → PHP → Composer，确认勾选Enable composer library detection，且composer.json路径指向项目根目录 - 如果刚改过 PSR-4 映射，记得运行
composer dump-autoload -o，否则 IDE 读不到新规则
手动删缓存目录前必须核对三件事
直接删 ~/.PhpStorm2025.3 或 ~/.cache/JetBrains/PhpStorm2025.3 确实快，但也最容易误伤：
- 确认当前正在使用的版本号（如
2025.3），只删非当前版本的目录（例如.PhpStorm2025.1可删，.PhpStorm2025.3不能乱动） - 确保 PhpStorm 已完全退出（任务管理器里无
java.exe或phpstorm64.exe进程残留） - 不要删
~/.PhpStorm2025.3/config下的主配置（如keymaps、templates），否则快捷键、Live Templates 全丢
真正占用空间的大户常是：system/caches（索引快照）、system/log（滚动日志）、~/.cache/JetBrains/PhpStorm2025.3（编译中间产物）。这些目录内容可安全清空，但删错版本号会导致 License 绑定丢失、个性化设置归零——别图快跳过核对。
