PhpStorm仍索引vendor和node_modules是因为其不读取.gitignore，必须右键目录→Mark as→Excluded（非Ignored），并确认Settings→Directories中已列出；同时需配JVM参数-Xms512m -Xmx2048m -XX:+UseG1GC -XX:ReservedCodeCacheSize=512m，改后重启生效。
为什么 vendor 和 node_modules 还在被索引
即使项目里有 .gitignore，PhpStorm 也完全不认它——索引行为和 Git 配置毫无关系。IDE 默认扫描整个项目根目录下所有子目录，vendor/ 和 node_modules/ 这类目录动辄几万甚至十万文件，一进项目就触发全量解析，直接卡死索引线程。
右键点击 vendor → Mark Directory as → Excluded（注意不是 Ignored）；同理处理 node_modules、storage/logs、bootstrap/cache、dist、build 等非源码目录
-
Excluded目录图标变红，彻底跳过语法解析、符号索引、补全支持 -
Ignored图标是黄色，仅隐藏文件列表，仍参与后台扫描——这是最常踩的坑 - 确认生效：打开
File > Settings > Directories，检查路径是否出现在Excluded区域 - 若用了 Composer 的
path类型本地包，需在Settings > Project > Project Structure > Modules中手动把对应路径设为Sources，否则 exclude 后跳转会失效
改了 phpstorm64.vmoptions 还是卡，参数到底怎么配
堆内存调大只是起点，JVM 参数不匹配或混用废弃选项，反而会让 GC 更频繁、UI 更卡顿，尤其在 JDK 17+ 下。
推荐最小可行配置（Ubuntu/Debian/CentOS 通用）：
立即学习“PHP免费学习笔记（深入）”；
-Xms512m -Xmx2048m -XX:+UseG1GC -XX:ReservedCodeCacheSize=512m -Dawt.java2d.opengl=true
- 删掉已废弃参数：
-XX:+UseConcMarkSweepGC（JDK 14+ 移除）、-XX:ParallelGCThreads（G1 下无效） -
-Dawt.java2d.opengl=true仅限 Intel/AMD 核显或主流独显；NVIDIA 旧驱动可能闪退，可先试加，异常则删掉 - 物理内存 16GB，
-Xmx别超 4096m；32GB 主机建议上限 6144m，但绝不能超过物理内存的 65% - 改完必须重启 PhpStorm，热重载无效；路径通常为
/opt/phpstorm/bin/phpstorm64.vmoptions或~/PhpStorm-*/bin/phpstorm64.vmoptions
索引卡住不动？大概率不是慢，是假死
CPU 占 100% 但进度条不动、改了文件没补全、搜索无响应——这不是“慢”，是索引树损坏导致的假死状态。缓存污染比参数错误更常见，尤其在频繁切换分支、升级插件或混入损坏的 JSON/PHPDoc 后。
- 立刻执行
File > Invalidate Caches and Restart > Invalidate and Restart（不是Clear） - 更彻底：关掉 PhpStorm 后运行
rm -rf ~/.cache/JetBrains/PhpStorm*，再重启 - 若反复出问题，说明某个文件触发了解析异常，可临时移走
resources/lang、config/下超大 YAML/JSON，或检查是否有二进制文件误混入src/ - 别等它自己恢复，索引进程不会自动修复损坏的内部结构
搜索慢、搜不到、Ctrl+Shift+N 响应延迟
Ctrl+Shift+N 是基于索引的文件名模糊匹配，一旦索引异常或干扰目录未排除，就会降级为低效遍历，输入后卡 2–3 秒是典型症状。
- 确保已排除
**/node_modules、**/vendor等路径（Settings > Directories支持通配符） - 关闭
Search in comments and strings（Settings > Editor > General > Search），能明显减少匹配开销 - 启用
CamelHumps后，搜ur可命中UserRepository.php；但禁用时，UserRe比userre快得多——大小写敏感匹配走索引，不敏感则全表扫 - 前缀通配符（如
*repo）无法利用索引，尽量用repo*或首字母组合（ur、lr） - 搜不到某文件？右键该文件 →
Reload from Disk，确认它没被意外剔出索引
真正卡顿的根源往往不在单点配置，而在多个环节叠加：一个被忽略的 Excluded、一行过时的 JVM 参数、一次没清理的缓存，三者叠在一起，就能让索引从秒级变成十分钟级。动手前先看一眼右下角索引进度条——它停在哪，问题就在哪。
