应优先用Ctrl+Shift+Alt+N搜符号（如方法名getUserById），因其基于AST解析、精准匹配且支持重命名联动；搜字符串字面量（如"cache_timeout"）则必须用Ctrl+Shift+F。
PhpStorm 的搜索功能不是“找文件”那么简单，它本质是代码理解能力的延伸——用对了，能直接跳过 80% 的手动翻查。
全局搜索 Ctrl+Shift+F 和符号搜索 Ctrl+Shift+Alt+N 到底该用哪个？
全局搜索适合查硬编码字符串、注释、配置值这类非结构化内容；符号搜索专为类名、函数名、方法名、接口、常量等语言级符号设计，走的是 AST 解析路径，结果精准、无误匹配、支持重命名联动。
- 搜
getUserById这种方法名，必须用Ctrl+Shift+Alt+N，否则可能命中注释里写的 “call getUserById()” 或拼错的变量名 - 搜
"cache_timeout"这种配置键，只能用Ctrl+Shift+F，符号搜索根本不会索引字符串字面量 -
Ctrl+Shift+Alt+N默认区分大小写且不模糊，想搜json匹配JsonResponse，得勾选 “Include non-physical files” 并启用 “Fuzzy search”（右下角齿轮图标）
为什么 Find in Path 搜不到刚改的代码？
常见原因是索引未更新或作用域被意外限制。PhpStorm 不是实时扫描磁盘，而是依赖后台索引，尤其在大项目中，改完文件后如果没触发自动索引（比如关掉了 “Synchronize files on frame activation”），或者你当前在 “Project Files” 范围内但文件被标记为 “Excluded”，就会漏掉。
- 检查右下角是否显示 “Indexing…” 或 “Index up to date”，若卡住可手动执行
File → Reload project from Disk - 确认搜索范围：默认是 “All Places”，但如果误点成 “Current File” 或 “Custom Scope”，结果会严重缩水
- 排除干扰：某些生成目录（如
vendor/composer/autoload_*.php）默认被排除，但如果你搜的是自定义 autoloader 逻辑，得临时取消排除（右键目录 → Mark Directory as → Not Excluded）
Ctrl+Click 跳转失效，Find Usages 返回空结果怎么办？
这通常不是功能坏了，而是 PhpStorm 没法推断类型上下文。典型场景包括动态调用（$obj->{$method}()）、魔术方法（__get/__call）、未声明返回类型的 PHPDoc、或使用了 @var 但拼写错误。
立即学习“PHP免费学习笔记（深入）”；
- 给动态属性加 PHPDoc：
/** @var User $user */，比/* @var $user User */更稳定（前者是 PSR-5 推荐格式） - 对魔术方法，补全
__call的 PHPDoc 注解，明确说明支持哪些方法名，例如：/** @method User find($id) */ - 检查
Settings → Editor → Inspections → PHP → Undefined class/method/property是否开启，关闭它会让跳转更“宽容”，但也掩盖真实问题
最麻烦的情况是混合了 Composer 自动加载和手动 require，导致类路径不一致；这时候索引看到的是一个路径，而运行时加载的是另一个——Find Usages 就永远找不到调用点。
