搜不到类名主因是索引未完成或配置错误；需检查右下角索引状态、确认src/app等目录未被Excluded、执行Reload project或Rebuild Index、运行composer dump-autoload、匹配PHP语言级别。
搜不到类名，基本不是你输错了，而是 PhpStorm 根本没把它当“类”来索引——索引状态、目录标记、PHP 语言级别、Composer 自动加载，四个环节任一断掉，Search Everywhere 就会静默失效。
为什么双击 Shift 搜 UserController 没结果
最常见原因是索引卡在“Indexing…”或压根没建好。右下角状态栏如果显示“Scanning files…”或空白，说明 IDE 还没完成初始解析。新拉的项目、刚改完 composer.json、或误把 app/ 目录标为 Excluded，都会导致类名不进索引。
- 检查 Settings → Directories，确认
src/、app/、packages/这类实际放代码的目录没被标红（Excluded） - 右键项目根目录 → Reload project from Disk，或点索引条右侧齿轮图标 → Rebuild Index
- 运行过
composer dump-autoload吗？没跑的话，哪怕文件存在，也不会被识别为可跳转的类 - 确保 Settings → Languages & Frameworks → PHP 中的 Language level 匹配你代码用的特性（比如用了 PHP 8.2 的只读属性，却设成 7.4，类会被跳过）
class UserController 这种前缀语法怎么用才准
默认搜 UserController 会混出文件、方法、设置项一堆结果，加 class 前缀能直切类定义，但空格和大小写有硬规则：空格是分隔符，classuser 不匹配 UserController；大小写不敏感，但首字母大写能大幅减少干扰项。
-
class User→ 匹配User.php、UserRepository.php，但不会拉出user_settings.php -
file config.php→ 只搜文件名，支持通配符，file *.env能定位所有环境配置 -
symfony command→ 需装 Symfony 插件，否则不生效 - 输完直接回车，别按方向键选中再回车——有时焦点错位会导致搜的是上一条历史记录
Ctrl+B 跳转失败，但 Search Everywhere 能搜到，说明啥
这说明类名已进索引，但符号解析链断了。典型场景是 vendor 里第三方包的类：UserController 能搜到，但 Ctrl+B 点它却提示 “Cannot find declaration”，大概率是 vendor/ 没被标为 Sources Root。
立即学习“PHP免费学习笔记（深入）”；
- 右键
vendor/目录 → Mark Directory as → Sources Root - 检查 File → Project Structure → Modules，确认
vendor/所在模块的 Sources 里包含该路径 - 如果用了 Laravel，确保 Laravel Plugin 已启用，且 Settings → Languages & Frameworks → PHP → Laravel 中勾选了 Enable Laravel support
- 刚执行
composer install后，别急着跳转，等右下角索引条走完再试
真正容易被忽略的是：Search Everywhere 不是“搜得快”，而是“搜得准”的前提——它不关心你当前在哪，只依赖索引质量。一旦索引漏掉某个目录，或者 PHP 解释器指向一个不兼容的版本，连 class 前缀都救不回来。与其反复重试快捷键，不如先盯住右下角那个小状态条。
