直接搜索 @return 注解最便捷：用 Ctrl+Shift+F 搜 @return\s+(array|bool|string)，勾选 Regex 和 Words only，Scope 设为 Project Files；Structural Search 可匹配真实 return 语句，需 PHP ≥7.4 且启用 strict_types；Quick Definition（Ctrl+Shift+I）能查看函数签名与推断类型；调试时 Frames 面板结合 Variables 查看实际返回值更可靠。
用 Find in Path 搜 @return 注解最直接
想快速找出项目里所有返回 array 或 bool 的函数，别去翻源码——直接搜 PHPDoc 的 @return 行。按 Ctrl+Shift+F（Windows/Linux）或 Cmd+Shift+F（macOS），输入 @return array，勾选 “Regex” 和 “Words only”，再把 Scope 设为 “Project Files”。
注意三点：
- 必须勾选
Words only，否则会匹配到array_merge这类函数名 -
@return后面可能有空格、换行或多个类型（如@return array|false），建议用正则@return\s+(array|bool|string) - 如果函数没写
@return，这招就失效——它只找注解，不分析实际返回逻辑
Structural Search 匹配真实返回语句更准
当你要找“实际返回数组的函数”，而不是“注释里写了 @return array 的函数”，就得用 Structural Search。按 Ctrl+Shift+A → 输入 “Structural Search” → 新建模板，写：return $expr$;，把 $expr$ 类型设为 “Expression”，再加约束：表达式类型包含 array。
这个方法能穿透动态赋值和类型推导，但要注意：
立即学习“PHP免费学习笔记（深入）”；
- 必须先确保项目已索引完成，否则类型信息为空
- PHP 版本需 ≥ 7.4，且启用了严格类型检查（
declare(strict_types=1);）才能获得可靠推断 - 像
return $data ?? [];这种三元结构，$expr$会捕获整个右值，但类型可能被推成mixed，得手动加@var注解辅助
用 Quick Definition（Ctrl+Shift+I）反向验证返回值
你看到一个函数调用，比如 $items = getActiveUsers();，想知道它到底返回什么？把光标停在 getActiveUsers 上，按 Ctrl+Shift+I。弹出面板里会显示它的签名、@return 注解，以及 PhpStorm 根据上下文推断出的实际类型（比如 App\Models\User[]）。
这个操作依赖两个前提：
- 函数定义处必须有
@return，或者函数本身有返回类型声明（如function getActiveUsers(): array） - 调用处的变量不能是动态构造的（如
$func = 'get'.ucfirst($type).'Users'; $func();），否则推断会退化为mixed - 如果面板里只显示
mixed，大概率是缺少 PHPDoc 或类型声明，不是 IDE 问题
调试时看 Frames 面板比静态搜索更可靠
静态分析再强，也覆盖不了运行时分支。比如一个函数在不同条件下分别返回 string、false、null，@return string|false|null 写全了，Structural Search 仍可能漏掉某条路径。
这时直接打断点，在 Frames 面板里看每次执行到底从哪一行 return 出来、返回值是什么类型，反而更快：
- 在函数第一行设断点，按
F7步入，观察每一步执行流 - 在
Variables面板里右键变量 → “View as Array” 或 “View as JSON”，能立刻确认结构是否符合预期 - 如果返回值是对象，点开它的
__CLASS__字段，比猜@return User更实在
真正难的不是找到返回类型，而是确认那个类型在当前上下文里是否稳定——比如一个返回 array 的函数，里面键名是否固定、是否可能为空、是否混入了非数组元素。这些靠搜索永远得不到答案，只能靠运行时观察。
