PhpStorm 默认将整个项目根目录视为源码区，导致 node_modules、vendor 等无关目录被索引拖慢速度并污染搜索结果；应右键目录→Mark Directory as→Excluded，彻底移除其语义分析。
PhpStorm 搜索和索引为什么总扫到 node_modules 或 vendor？
因为 phpstorm 默认把整个项目根目录当「源码区」，只要在项目内，不管是不是代码、有没有用，它都照单全收——node_modules、vendor、dist、build 这些目录体积大、文件多、结构深，一来拖慢索引速度，二来让「全局搜索」结果混入大量无关内容，跳转也容易误入。
怎么把目录加进 PhpStorm 的「排除列表」？
不是靠 .gitignore，也不是改配置文件，而是直接在项目结构里标记为「Excluded」——这个状态会同时影响索引、搜索、代码补全和重构范围。
- 右键目标目录（比如
node_modules）→ Mark Directory as → Excluded - 如果目录不存在于项目视图中（比如被 .gitignore 隐藏了），先点左上角 Project 下拉菜单 → 选 Show All Files，再找到并右键
- 排除后，目录名变成灰色，且右下角状态栏会提示「Indexing paused for excluded files」
- 已排除的目录仍可手动打开单个文件，但不会参与任何智能分析
exclude 和 Mark as Plain Text 有什么区别？
Mark as Plain Text 只是关掉语法高亮和语言特性，目录依然被索引；而 Excluded 是彻底从 PhpStorm 的语义分析体系中移除——前者是「我看不懂你」，后者是「我根本不看你」。
- 误用
Mark as Plain Text处理vendor，搜索Carbon::now()仍可能匹配到 Laravel 的 vendor 文件里，干扰结果 -
Excluded后，Ctrl+Click 跳转、Find Usages、Rename 等功能完全无视该目录下的符号 - 某些插件（比如 PHP Annotations）依赖索引数据，排除不当会导致注解解析失败
哪些目录建议排除？哪些一定不能排除？
排除不是越狠越好，关键看是否参与运行时逻辑或开发流程。
- 推荐排除：
node_modules、vendor/composer/autoload_*.php（非主 autoload）、dist、build、storage/logs、cache - 谨慎排除：
vendor/autoload.php（它是 PSR-4 自动加载入口，排除会导致类无法识别） - 绝对不要排除：
app、src、config、routes、tests—— 即使它们暂时空着，也要留作语义上下文 - CI/CD 生成的临时目录（如
.phpstorm.meta.php所在位置）不需手动排除，PhpStorm 会自动忽略
排除操作本身不写入版本控制，但会保存在 .idea/workspace.xml 的 contentRoot 节点里。团队协作时，建议把常用排除规则同步进 .idea/modules.xml（需手动维护），否则新成员打开项目还得重做一遍。
立即学习“PHP免费学习笔记（深入）”；
