PhpStorm 补全卡顿主因是索引未正确排除 vendor 和 node_modules、缓存损坏或 JVM 内存配置不当；需标记为 Excluded、清缓存、调优 vmoptions 并逐项验证。
代码提示慢，90% 不是 PHP 本身问题，而是 PhpStorm 的索引没对齐——vendor 和 node_modules 还在被解析，缓存已损坏，或 JVM 没喂够内存。改三处、清一次，基本就快了。
为什么 Ctrl+Space 补全卡顿超过 1 秒
补全依赖实时符号索引，而 PhpStorm 默认会递归扫描整个项目目录。一旦 vendor 或 node_modules 被纳入索引范围，IDE 就得为几万个类/函数建立类型映射，CPU 持续满载，补全自然延迟。
- 现象：输入
Str::后等 2 秒才弹出方法列表；use补全不出现；new后类名不自动提示 - 根本原因不是“网络慢”或“PHP 版本低”，而是索引树里混进了不该有的路径
-
.gitignore完全无效——PhpStorm 不读它来跳过索引 - 右键选
Ignored也不行，只有Excluded才真正从符号解析中移除目录
怎么正确排除 vendor 和 node_modules
必须用 Mark Directory as → Excluded，图标变成红灰色才算生效；仅加到 .gitignore 或 Settings → File Types → Ignore files and folders 都不阻止索引。
- 右键项目根目录下的
vendor→Mark Directory as → Excluded - 同理处理
node_modules、storage/logs、bootstrap/cache、dist、build - 确认生效：进入
File → Settings → Directories，检查这些路径是否列在Excluded区域 - ⚠️ 坑：如果目录仍是黄色图标，说明只被
Ignored，没真正排除——补全照样慢 - 排除后跳转失效？手动把关键子路径设回
Sources Root：比如vendor/laravel/framework→ 右键 →Mark as → Sources Root（大小写敏感，不能漏framework）
缓存损坏比索引慢更常见
索引进程挂起、补全偶尔失灵、修改文件后提示不更新——大概率不是慢，是缓存树坏了，IDE 在假死状态硬扛。
立即学习“PHP免费学习笔记（深入）”；
- 别等它自己恢复，直接执行
File → Invalidate Caches and Restart → Invalidate and Restart - 更彻底：关掉 PhpStorm 后运行
rm -rf ~/.cache/JetBrains/PhpStorm*（Linux/macOS）或删对应 Windows 缓存路径 - 重启后首次打开会重建索引，但之后补全响应明显加快
- 反复出问题？说明某个文件触发了解析异常，常见于超大 JSON、损坏的 PHPDoc、或二进制混入
src
JVM 参数错配会让补全雪上加霜
堆内存太小会导致频繁 GC，补全弹出前要等一轮回收；太大又挤占系统资源，触发 swap，反而更卡。关键是匹配物理内存并加必要参数。
- 编辑
phpstorm64.vmoptions（Linux/macOS 路径通常为~/PhpStorm-*/bin/phpstorm64.vmoptions） - 推荐配置（16GB 内存机器）：
-Xms2048m-Xmx4096m-XX:+UseG1GC-XX:ReservedCodeCacheSize=512m - 删掉已废弃参数，如
-XX:+UseConcMarkSweepGC（JDK 14+ 已移除） - 改完必须重启 PhpStorm 进程，
Invalidate Caches不会重载 JVM 参数 - 验证：启动后点
Help → Diagnostic Tools → Memory Indicator，观察 “Used/Total” 是否稳定在 60% 以内
真正拖慢补全的，往往不是配置没调，而是 Excluded 没做全、缓存清得不干净、或者 vmoptions 改了但改错了位置（比如改了旧版本 bin 目录）。建议每次只动一项，重启后验证效果，别堆在一起猜。
