PhpStorm 卡顿主因是 vendor 目录被全量索引；应先整体排除 vendor，再将 laravel/framework 等关键包设为 Sources Root，并关闭 Composer auto-import 和 vendor 中未定义符号检查。
为什么 vendor 目录会让 PhpStorm 卡得像在编译 Linux 内核
因为 vendor 里通常有几万甚至几十万个 php 文件，而 phpstorm 默认会为每个文件建立符号索引、类型推导和代码补全数据。一旦你运行过 composer install，ide 就开始默默解析所有包的类、函数、注释——这不仅拖慢首次打开项目的速度，还会让后续的“go to definition”、重命名、全局搜索变迟钝，甚至触发内存溢出（outofmemoryerror）。
真正的问题不是“要不要排除”，而是“怎么排除才不伤功能”：比如你仍需要 laravel/framework 的类跳转，但不需要 phpunit/phpunit 里那 2000 个测试辅助类参与索引。
- 别用“Mark Directory as Excluded”粗暴右键——它会彻底禁用该目录下所有代码提示和引用查找
- 优先走
Settings > Directories > Excluded，这是 IDE 级别的索引屏蔽，不影响外部工具链（如 PHPStan、Psalm）扫描 - 如果用了 Laravel 或 Symfony，建议额外把
storage/logs、bootstrap/cache也加进排除列表，它们虽小但频繁写入，容易引发索引反复刷新
如何精准排除 vendor 但保留关键包的代码提示
直接排除整个 vendor 目录最省事，但代价是：你点不了 AppServiceProvider 里 use Illuminate\Support\Str; 的跳转。解决办法是“排除 vendor 大部分，再单独启用少数”。
- 先在
Settings > Directories中把vendor标为 Excluded - 然后点击左上角
+添加新路径，填入vendor/laravel/framework（或你实际依赖的核心框架路径） - 对这个子路径右键 →
Mark as > Sources Root，这样只有它被索引，其余vendor/*保持静默 - 注意路径必须精确——
vendor/laravel不行，必须是完整包名路径；大小写也要匹配（Windows 下常因大小写不敏感掩盖问题）
排除后仍被索引？检查这三项隐藏配置
有时候你明明标了 Excluded，但 PhpStorm 还在后台啃 vendor，大概率是下面三个地方悄悄开了后门：
-
Settings > Languages & Frameworks > PHP > Composer里勾了Enable auto-import for Composer packages——关掉，它会强制拉取并索引autoload.php引用的所有路径 -
Settings > Editor > Inspections > PHP > Undefined class / function下如果启用了Report undefined symbols in vendor directories，也会反向触发索引 - 项目根目录存在
.idea/misc.xml，里面可能残留旧版的<option name="excludedPaths" value="..."></option>配置，手动删掉比 GUI 操作更可靠
Mac/Windows/Linux 下路径排除的兼容性差异
排除路径本身没系统差异，但实际效果受文件系统行为影响：
立即学习“PHP免费学习笔记（深入）”；
- macOS 上若用 APFS 快照或 Time Machine 备份，
vendor目录可能被挂载为只读，导致 PhpStorm 索引时反复报错java.io.IOException: Read-only file system——此时排除不仅是提速，更是避免日志刷屏 - Windows 用户要注意反斜杠：
vendor\monolog\monolog在设置里必须写成正斜杠vendor/monolog/monolog，否则 IDE 识别失败 - WSL2 环境下，如果项目放在
/mnt/c/...路径，PhpStorm（Windows 版）可能无法正确监听文件变更，建议把项目移到~/projects并用 WSL 版 PhpStorm 打开
排除不是一劳永逸的事——每次 composer update 后，新增包不会自动加入索引，但也不会意外拖慢 IDE；如果你突然发现某个新装的包无法跳转，先确认它是否在你手动标记的 Sources Root 列表里。真正的麻烦往往藏在“以为排除了，其实没生效”的路径拼写和权限细节里。
