90%的索引卡死问题可通过删除.idea/index/或执行Invalidate Caches and Restart解决；根本原因是某文件（如超大JSON、损坏stub）触发解析异常导致索引线程挂起，需结合日志排查StackOverflowError等错误并针对性修复。
索引卡住不动，代码跳转失效，不是项目大，是索引进程假死了——直接删 .idea/index/ 或执行 Invalidate Caches and Restart，90% 的问题当场解决。
为什么索引进度条卡住、Ctrl+Click 无响应
这不是“慢”，是索引树损坏或解析阻塞。常见信号包括：右下角长期显示 “Indexing…”、CPU 占满但进度不动、新文件不进搜索结果、Ctrl+Click 提示 “Cannot find declaration to go to”。根本原因往往是某个文件触发解析异常（比如超大 JSON、混入二进制的 PHPDoc、损坏的 stub），导致整个索引线程挂起。
- 别等它自己好——PhpStorm 不会自动跳过坏文件
- 别只点
Reload project from Disk：它只同步文件列表，不重建索引库 - 确认是否真卡住：打开
Help > Diagnostic Tools > Show Log in Explorer，搜index或exception，看最后几条有没有StackOverflowError或IOException
强制重建索引的两种可靠操作
轻量级修复适用于刚切分支、手动挪过文件、或索引脱节；重度修复用于反复卡死、跳转错乱、搜索完全失效。
-
轻量：菜单触发重建
执行File > Invalidate Caches and Restart > Invalidate and Restart。
它会清空.idea/caches/和.idea/index/，但保留.idea/workspace.xml（你的断点、窗口布局还在） -
重度：手动删 index 目录
关闭 PhpStorm → 进项目根目录 → 删除.idea/index/文件夹（Windows/macOS/Linux 路径一致）→ 重新打开项目
比 Invalidate 更干净，绕过 GUI 缓存残留，特别适合misc.xml里有错误excludedPaths配置的情况
排除 vendor 后跳转仍失败？检查这三个隐藏开关
标了 Excluded 不代表 IDE 彻底放手——以下三处配置会悄悄重启对 vendor/ 的扫描，让跳转和补全持续失灵：
立即学习“PHP免费学习笔记（深入）”；
-
Settings > PHP > Composer中勾选了Enable auto-import for Composer packages→ 关掉 -
Settings > Editor > Inspections > PHP > Undefined class / function启用了Report undefined symbols in vendor directories→ 关掉 - 项目根目录下
.idea/misc.xml里残留旧配置：<option name="excludedPaths" value="">→ 直接删掉整行（GUI 操作有时不同步）
Linux 下 inotify 耗尽会让排除失效
就算你把 node_modules 标为 Excluded，Linux 默认的 inotify 句柄上限（8192）也可能被撑爆，导致 PhpStorm 根本无法监听文件变化，连排除状态都不同步——表现为“已排除却仍在扫描”、“右键菜单变灰”、“索引进度条卡在 0%”。
- 查当前值：
cat /proc/sys/fs/inotify/max_user_watches - 临时调高：
sudo sysctl -w fs.inotify.max_user_watches=524288 - 永久生效：往
/etc/sysctl.conf追加fs.inotify.max_user_watches=524288
这步做完，必须重启 PhpStorm 才生效。很多团队只做目录排除却忽略这个，结果白调半天内存参数。
