Ctrl+N专搜类声明，精准高效；双击Shift混搜所有类型易干扰。它依赖索引状态、正确目录作用域及PHP文件类型，任一出错均导致静默失效。
直接用 Ctrl + N（Windows/Linux）或 Cmd + O（macOS）——这是专为类名设计的索引搜索，不是文件名匹配，也不是全文扫描。
为什么 Ctrl + N 比双击 Shift（Search Everywhere）更准
Search Everywhere（双击 Shift）默认混搜所有类型：文件、类、方法、设置项、命令……容易被无关结果淹没。而 Ctrl + N 一启动就只查类（含接口、trait、enum），自动走 PHP 类名索引，响应快、误匹配少。
- 搜
User，它不会返回UserController.php文件（那是Ctrl + Shift + N干的事），而是精准列出User类、UserInterface、UserFactory等真实类声明 - 支持命名空间缩写：输
Auth\User或User@auth都能命中App\Auth\User - 如果项目用了 Composer autoload，但新类没进索引，
Ctrl + N就搜不到——此时不是快捷键问题，是composer dump-autoload没跑或索引卡在 “Indexing…” 状态
Ctrl + N 搜不到类？先盯住右下角状态栏
它不报错，但静默失败极常见。关键判断依据只有两个字：Indexing…。
- 只要右下角还在显示
Indexing…或Scanning files…，所有类/方法搜索都不可信，等它消失再试 - 手动重建索引：菜单
File → Reload project from Disk，或点索引条右侧齿轮图标 →Rebuild Index - 检查目录是否被误排除：进入
Settings → Directories，确认app/、src/、vendor/这些路径没出现在Excluded列表里 - PHP 语言级别设错也会导致类解析失败：去
Settings → Languages & Frameworks → PHP，确保版本 ≥ 你代码实际使用的（比如用了 PHP 8.2 的只读属性，却设成 7.4，类就进不了索引）
类名拼写正确却没结果？可能是作用域或文件类型问题
Ctrl + N 只识别被 PhpStorm 当作 PHP 类处理的文件。以下情况会导致“类存在但搜不到”：
立即学习“PHP免费学习笔记（深入）”；
- 文件后缀不是
.php（比如.inc或无后缀 helpers 文件）→ 右键该文件 →Override File Type → PHP - 类定义在
require_once 'helpers.php'这类非标准加载路径里 → 进入Settings → PHP → Include Paths，把该目录手动加进去 - 项目不是从根目录打开的（比如只打开了
web/子目录）→ 关闭项目，重新用包含composer.json的根目录打开，否则vendor/和src/不在作用域内 - 类用了动态命名（如
class {$name}）或字符串拼接（new $className()）→ 这种无法被静态索引，Ctrl + N天然不支持
真正麻烦的不是记不住快捷键，而是索引状态、作用域和文件类型这三者之间互相咬合。哪怕只错一个，Ctrl + N 就会“假装正常运行”，但结果为空——这种静默失效，比报错更难排查。
