必须从源头限制文件类型，用 file 前缀限定扩展名（如 file *.php），配合 Scope 排除 vendor 等目录，并确保目录被设为 Excluded 而非仅 Ignored，才能避免结果淹没和性能暴跌。
不能靠“搜索完再筛选”，必须从源头限制文件类型，否则 vendor、.log、.js 会淹没结果，且性能暴跌。
用 file 前缀限定扩展名（最常用）
Search Everywhere（双击 Shift）和全局搜索（Ctrl+Shift+F）都支持前缀语法，file 是最直接的扩展名过滤方式：
-
file *.php→ 只匹配 PHP 文件（含.blade.php、.api.php等，只要后缀以.php结尾） -
file config.*→ 匹配config.php、config.yaml、config.env -
file *.blade.php→ 精确匹配 Blade 模板（注意：不是*.blade，后者不生效） - 多个扩展名用空格分隔：
file *.php *.js *.vue
⚠️ 常见错误：写成 file php 或 file .php —— 这两个都不识别，file 后必须跟带通配符的完整模式。
在搜索对话框里设 Scope + File Mask（适合 Ctrl+Shift+F）
打开 Ctrl+Shift+F，点击左下角 Scope 下拉菜单 → Edit Scopes… → + Add scope：
立即学习“PHP免费学习笔记（深入）”；
- 选
Custom，命名如PHP Core Files - Pattern 填：
file:*.php && !file:vendor/* && !file:node_modules/* - 保存后，在搜索框下方
Scope切到这个新范围即可
关键点：file: 是路径匹配语法，&& 表示且，! 表示排除；这种写法比纯 file *.php 更精准，能同时排除无关目录。
为什么 file *.php 有时仍搜出 .js？
不是语法错，而是索引污染或类型映射冲突：
- 检查
Settings → Editor → File Types，确认.js没被误加进PHP的Registered Patterns - 如果
routes.api被识别为PHP类型（因加了*.api），它也会响应file *.php—— 因为 PhpStorm 按「文件类型」而非「扩展名字符串」匹配 - 已排除的目录（如
vendor）若未真正设为Excluded（只是Ignored），仍可能参与搜索
验证方式：右键任一 .js 文件 → Override File Type → 看当前显示的是什么类型。
想永久默认只搜 PHP/Blade/YAML？改默认 Scope
不想每次输前缀，可把常用扩展绑定到项目默认搜索范围：
- 进入
Settings → Appearance & Behavior → System Settings - 找到
Default search scope，点右侧… - 选
Custom→ Pattern 填：file:*.php || file:*.blade.php || file:*.yaml || file:*.yml - 勾选
Include tests或取消，按需调整
⚠️ 注意：这个设置影响所有搜索入口（Ctrl+N、Ctrl+Shift+F、双击 Shift），但不会改变索引行为——Excluded 目录依然不参与，这点不能跳过。
真正卡住搜索效率的从来不是语法，而是 vendor 和日志目录是否被正确 Excluded；file 前缀再准，也救不了还在索引百万个 .js 的项目。
